SQLSetDescRec-設定描述子記錄

線上編輯

SQLSetDescRec() 會設定描述子記錄的所有屬性。 SQLSetDescRec() 是 SQLSetDescField() 函數的更簡要替代方案。

語法

SQLRETURN SQLSetDescRec (SQLHDESC       hdesc,
                         SQLSMALLINT    irec,
                         SQLSMALLINT    type,
                         SQLSMALLINT    subtype,
                         SQLINTEGER     length,
                         SQLSMALLINT    prec,
                         SQLSMALLINT    scale,
                         SQLPOINTER     data,
                         SQLINTEGER     *sLen,
                         SQLINTEGER    *indic);

函數引數

表 1. SQLSetDescRec 引數
資料類型 引數 使用 說明
SQLDESC hdesc 輸入 描述子控點。
SQLSMALLINT irec 輸入 描述子內的記錄號碼。
SQLSMALLINT 類型 輸入 記錄的 TYPE 欄位。
SQLSMALLINT 子類型 輸入 TYPE 是 SQL_DATETIME 之記錄的 DATETIME_INTERVAL_CODE 欄位。
SQLINTEGER 長度 輸入 記錄的 LENGTH 欄位。
SQLSMALLINT 前置作業 輸入 記錄的「精準度」欄位。
SQLSMALLINT 比例 輸入 記錄的 SCALE 欄位。
SQLPOINTER 資料 輸入 (延遲) 記錄的 DATA_PTR 欄位。
SQLINTEGER * sLen 輸入 (延遲) 記錄的 LENGTH_PTR 欄位。
SQLINTEGER * 靛藍色 輸入 (延遲) 記錄的 INDICATOR_PTR 欄位。

用法

呼叫 SQLSetDescRec() 會在一次呼叫中設定描述子記錄中的所有欄位。

回覆碼

  • SQL_SUCCESS
  • SQL_SUCCESS_WITH_INFO
  • SQL_ERROR
  • SQL_INVALID_HANDLE

診斷

表 2. SQLSetDesc記錄 SQLSTATE
SQL狀態 說明 說明
HY009 無效的引數值 指定給引數 irec 的值小於 1。

指定的值對另一個引數無效。
HY016 無效的描述子 描述子控點參照實作列描述子。
HY021 無效的內部描述子 內部描述子無法定址或配置，或包含無效的值。

參照