历史版本。 PostgreSQL 9.1 已结束支持。 2016-10-27. 请参阅 当前版本手册.
SPI_cursor_open_with_paramlist
SPI_cursor_open_with_paramlist — set up a cursor using parameters
大纲
Portal SPI_cursor_open_with_paramlist(const char *name, SPIPlanPtrplan, ParamListInfoparams, boolread_only)
描述
SPI_cursor_open_with_paramlist 建立一个游标（在内部是一个 portal），该游标将执行由
SPI_prepare 准备好的计划。该函数等价于
SPI_cursor_open，只是向查询传递参数值信息的形式不同。ParamListInfo 表示形式便于传递已经按这种格式存在的值，也支持通过 ParamListInfo 中指定的钩子函数使用动态参数集。
传入的参数数据会被复制到该游标的 portal 中，因此即使该游标仍然存在，也可以释放这些参数数据。
参数
const char *nameportal 的名称，或为
NULL以让系统选择名称SPIPlanPtrplan执行计划（由
SPI_prepare返回）ParamListInfoparams包含参数类型和值的数据结构；没有参数时为 NULL
boolread_onlytrue表示只读执行
返回值
指向包含该游标的 portal 的指针。注意这里没有错误返回约定，任何错误都将通过elog报告。