SQLCloseCursor -關閉游標陳述式

線上編輯

SQLCloseCursor() 會關閉陳述式控點上的開啟游標。

語法

SQLRETURN SQLCloseCursor (SQLHSTMT     hstmt);

函數引數

表 1. SQLCloseCursor 引數
資料類型 引數 使用 說明
SQLHSTMT hstmt 輸入 陳述式控點

用法

呼叫 SQLCloseCursor() 會關閉與陳述式控點相關聯的任何游標，並捨棄任何擱置中的結果。 如果沒有開啟游標與陳述式控點相關聯，則函數沒有作用。

如果陳述式控點參照具有多個結果集的儲存程序，則 SQLCloseCursor() 只會關閉現行結果集。 任何其他結果集都會保持開啟且可用。

回覆碼

  • SQL_SUCCESS
  • SQL_INVALID_HANDLE
  • SQL_ERROR

診斷

表 2. SQLCloseCursor SQLSTATE
SQL狀態 說明 說明
08003 * 連線未開啟 未建立 hstmt 的連線。
HY009 * 無效的引數值 hstmt 不是陳述式控點。
HY021 無效的內部描述子 內部描述子無法定址或配置，或包含無效的值。