SQLSetDescField

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics 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 實作詳細資料