# SPI_cursor_open_with_paramlist ## Name SPI_cursor_open_with_paramlist -- 使用参数设置一个游标 ## Synopsis ``` 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`， 除了要传递给查询的有关参数值信息的表现不同。`ParamListInfo` 表示法可以方便的传递早已在该格式中可用的值。它也支持使用动态参数设置， 通过`ParamListInfo`中指定的hook函数。 传入参数数据将被拷贝到游标的入口，所以它在游标仍然存在时可以被释放。 ## 参数 `const char *` `name` 入口的名字，或者是`NULL`让系统选择一个名字 `SPIPlanPtr` `plan` 预备语句（`SPI_prepare`返回的） `ParamListInfo` `params` 包含参数类型和值的数据结构；如果没有则为NULL `bool` `read_only` `true`用于只读的执行 ## 返回值 指向包含游标入口的指针。请注意，这里没有错误返回约定； 任何错误都将通过`elog`报告。