SPI_saveplan

Name

SPI_saveplan -- 保存一個規劃

Synopsis

void * SPI_saveplan(void * plan)

描述

SPI_saveplan 在內存裡保存一個傳遞進來的規劃(用 SPI_prepare 準備的), 避免它被 SPI_finish 和事務管理器釋放,並且返回一個指向保存的規劃的指針。 這樣就給你在當前繪畫裡的隨後的調用中復用這個準備好的規劃的能力。 你可以在一個局部變量裡保存這個指針。在準備一個規劃或者在 SPI_execp 裡使用一個已經準備好的規劃的時候, 一定要檢查這個指針是否為 NULL

參數

void * plan

要保存的規劃

返回值

指向保存的規劃的指針;如果不成功則為 NULL。 出錯的時候,像下面這樣設置 SPI_result

SPI_ERROR_ARGUMENT

如果 planNULL

SPI_ERROR_UNCONNECTED

如果從一個未連接的過程中調用

注意

如果會話過程中,準備好的規劃引用的一個對象(一個表,函數,等等)被刪除, 那麼 SPI_execp 執行此規劃的結果將不可預期。