SQLSetDescField

適用範圍: 是SQL Server (所有支援的版本) 是Azure SQL Database 是Azure SQL 受控執行個體 是Azure Synapse Analytics 是平行處理資料倉儲

SQLSetDescField 可以用來設定資料表值參數和資料表值參數資料行的描述項欄位。 如需可用欄位的詳細資訊,請參閱 資料表值參數描述項欄位 以及 Table-Valued 參數組成資料行的描述項欄位

備註

只有當描述項標頭欄位 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 支援) (Udt 的大型 CLR 使用者自訂類型。 如需詳細資訊,請參閱 (ODBC)的大型 CLR User-Defined 類型

疏鬆資料行的 SQLSetDescField 支援

SQLSetDecField 可以用來將應用程式參數描述項中的 SQL_SOPT_SS_NAME_SCOPE 設定 (APD) SQL_SS_NAME_SCOPE_EXTENDED 和 SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET 的值。

如需詳細資訊,請參閱 (ODBC)的稀疏資料行支援

另請參閱

SQLSetDescField
ODBC API 實作詳細資料