# SPI_光标_打开_和_参数列表

SPI_光标_打开_和_paramlist — 使用参数设置游标

# 概要

Portal SPI_cursor_open_with_paramlist(const char *name,
                                      SPIPlanPtr plan,
                                      ParamListInfo params,
                                      bool read_only)

# 描述

SPI_cursor_open_with_paramlist设置一个游标(内部是一个门户),它将执行由SPI_prepare.这个函数相当于SPI_cursor_open除了有关要传递给查询的参数值的信息以不同的方式呈现。这参数列表信息表示可以方便地传递该格式中已经可用的值。它还支持通过指定的钩子函数使用动态参数集参数列表信息.

传入的参数数据将被复制到游标的门户中,因此可以在游标仍然存在时将其释放。

# 论据

常量字符 * *姓名*

门户名称,或空值让系统选择一个名字

SPIPlanPtr *计划*

准备好的语句(由SPI_prepare)

参数列表信息 *参数*

包含参数类型和值的数据结构;如果没有则为 NULL

布尔 *只读*

真的用于只读执行

# 返回值

指向包含光标的门户的指针。注意没有错误返回约定;任何错误都会通过elog.