历史版本。 PostgreSQL 10 已结束支持。 2022-11-10. 请参阅 当前版本手册.
SPI_cursor_open_with_paramlist
SPI_cursor_open_with_paramlist — 使用参数建立一个游标
大纲
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 报告。