SPI_cursor_open_with_paramlist — パラメータを使ってカーソルを設定する
Portal SPI_cursor_open_with_paramlist(const char *name
, SPIPlanPtrplan
, ParamListInfoparams
, boolread_only
)
SPI_cursor_open_with_paramlist
はSPI_prepare
で準備された文を実行するカーソル(内部的にはポータル)を設定します。
この関数はSPI_cursor_open
と同じですが、問い合わせに渡されるパラメータ値に関する情報が別途存在することが異なります。
ParamListInfo
表現は、すでに利用可能な形式で値を渡すために便利です。
またParamListInfo
で指定されたフック関数経由での動的なパラメータ群の使用をサポートします。
渡されるパラメータデータはカーソルのポータルにコピーされます。 そのため、カーソルが存在している間にそのデータを解放することができます。
const char * name
ポータルの名前、あるいはシステムに名前を決定させる場合はNULL
SPIPlanPtr plan
(SPI_prepare
で返される)準備済み文
ParamListInfo params
パラメータの型と値からなるデータ構造。 なければヌル。
bool read_only
読み取りのみの実行の場合true
カーソルを含むポータルへのポインタ。
戻り値の規約にはエラーを表すものがないことに注意してください。
エラーはすべてelog
経由で報告されます。