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経由で報告されます。