SQLNumParams -取得 SQL 陳述式中的參數數目

線上編輯

SQLNumParams() 會傳回 SQL 陳述式中參數標記的數目。

語法

SQLRETURN   SQLNumParams     (SQLHSTMT          StatementHandle,
                              SQLSMALLINT       *ParameterCountPtr);

函數引數

表 1. SQLNumParams 個引數
資料類型 引數 使用 說明
SQLHSTMT StatementHandle 輸入 陳述式控點。
SQLSMALLINT * ParameterCountPtr 輸出 陳述式中的參數數目。

用法

只有在已備妥與 StatementHandle 相關聯的陳述式之後，才能呼叫此函數。 如果陳述式不包含任何參數記號，則 ParameterCountPtr 會設為 0。

應用程式可以呼叫此函數，以判定與陳述式控點相關聯的 SQL 陳述式需要多少個 SQLBindParameter() 呼叫。

回覆碼

  • SQL_SUCCESS
  • SQL_SUCCESS_WITH_INFO
  • SQL_ERROR
  • SQL_INVALID_HANDLE

錯誤狀況

表 2. SQLNumParams SQLSTATE
SQL狀態 說明 說明
40003 08S01 通訊鏈結失敗 在完成功能之前，應用程式與資料來源之間的通訊鏈結失敗。
HY001 記憶體配置失敗 Db2® for i CLI 無法配置支援處理或完成函數所需的記憶體。
HY008 作業已取消  
HY009 無效的引數值 ParameterCountPtr 是空值。
HY010 函數順序錯誤 在針對指定的 StatementHandle 呼叫 SQLPrepare() 之前，會先呼叫此函數。

在處理資料時 (SQLParamData()， SQLPutData()) 作業中呼叫此函數。
HY013 非預期的記憶體處理錯誤 Db2 for i CLI 無法存取支援處理或完成函數所需的記憶體。
HYT00 逾時過期  

限制

無。

範例

請參閱 SQLNativeSql -取得原生 SQL 文字中的範例。

參照