PostgreSQL 9.4.4 中文手册
上一页 | 上一级 |  | 下一页

# SPI_cursor_open_with_paramlist

## 名称

SPI_cursor_open_with_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`， 除了要传递给查询的有关参数值信息的表现不同。`ParamListInfo` 表示法可以方便的传递早已在该格式中可用的值。它也支持使用动态参数设置， 通过`ParamListInfo`中指定的hook函数。

传入参数数据将被拷贝到游标的入口，所以它在游标仍然存在时可以被释放。

## 参数

`const char * `name``

  入口的名字，或者是`NULL`让系统选择一个名字

`SPIPlanPtr `plan``

  预备语句（`SPI_prepare`返回的）

`ParamListInfo `params``

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

`bool `read_only``

  `true`用于只读的执行

## 返回值

指向包含游标入口的指针。请注意，这里没有错误返回约定； 任何错误都将通过`elog`报告。

上一页 | 起始页 | 下一页
SPI_cursor_open_with_args | 上一级 | SPI_cursor_find