SQLSetDescField

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System （PDW）

SQLSetDescField 可用來設定數據表值參數和數據表值參數數據行的描述元欄位。 如需可用欄位的相關信息，請參閱數據表值參數組成數據行的數據表值參數描述元欄位和描述元欄位。

備註

只有在描述項標頭欄位SQL_SOPT_SS_PARAM_FOCUS設定為SQL_DESC_TYPE設定為SQL_SS_TABLE的記錄序數時，才能使用數據表值參數數據行。 如需SQL_SOPT_SS_PARAM_FOCUS的詳細資訊，請參閱 SQLSetStmtAttr。

如果嘗試將SQL_SOPT_SS_PARAM_FOCUS設定為不是數據表值參數的參數序數，SQLSetStmtAttr 會傳回SQL_ERROR，並使用 SQLSTATE = HY024 和訊息「無效的屬性值」建立診斷記錄。 傳回SQL_ERROR時，SQL_SOPT_SS_PARAM_FOCUS不會變更。

將SQL_SOPT_SS_PARAM_FOCUS設定為 0 可還原參數描述項記錄的存取權。

如需資料表值參數的詳細資訊，請參閱 資料表值參數 （ODBC） 。

增強日期和時間功能的 SQLSetDescField 支援

ODBC 中已增強日期/時間功能。 如需針對新日期/時間類型提供之描述元欄位的資訊，請參閱 參數和結果元數據。

如需詳細資訊，請參閱 日期和時間改善 （ODBC）。

大型 CLR UDT 的 SQLSetDescField 支援

SQLSetDescField 支援大型 CLR 使用者定義型別 （UDT）。 如需詳細資訊，請參閱 大型CLR使用者定義型別 （ODBC）。

疏鬆數據行的 SQLSetDescField 支援

SQLSetDecField 可用來將應用程式參數描述元 （APD） 中的SQL_SOPT_SS_NAME_SCOPE設定為值SQL_SS_NAME_SCOPE_EXTENDED和SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET。

如需詳細資訊，請參閱 疏鬆資料行支援 （ODBC） 。

另請參閱

SQLSetDescField
ODBC API 實作詳細數據