# 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`報告。