SQLSetDescField
適用対象: 
SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
SQLSetDescField を使用して、テーブル値パラメーターとテーブル値パラメーター列の記述子フィールドを設定できます。 使用可能なフィールドの詳細については、「テーブル値パラメーター構成列の テーブル値パラメーター記述子フィールド および Descriptor フィールド」を参照してください。
解説
テーブル値パラメーター列は、記述子のヘッダー フィールド 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 とメッセージ "Invalid attribute value" を使用して診断レコードが作成されます。 SQL_SOPT_SS_PARAM_FOCUS は、SQL_ERROR が返されたときに変更されません。
SQL_SOPT_SS_PARAM_FOCUS に 0 を設定すると、パラメーターの記述子レコードへのアクセスが復元されます。
テーブル値パラメーターの詳細については、「 Table-Valued Parameters (ODBC)」を参照してください。
SQLSetDescField による機能強化された日付と時刻のサポート
ODBC では、日付と時刻の機能が強化されました。 新しい日付/時刻型に指定された記述子フィールドの詳細については、「 パラメーターと結果メタデータを参照してください。
詳細については、「 Date and Time Improvements (ODBC)」を参照してください。
SQLSetDescField による大きな CLR UDT のサポート
SQLSetDescField では、大きな CLR ユーザー定義型 (UDT) がサポートされています。 詳細については、「 Large CLR ユーザー定義型 (ODBC)を参照してください。
SQLSetDescField によるスパース列のサポート
SQLSetDecField を使用すると、アプリケーション パラメーター記述子 (APD) のSQL_SOPT_SS_NAME_SCOPEをSQL_SS_NAME_SCOPE_EXTENDED値とSQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET値に設定できます。
詳細については、「 Sparse Columns Support (ODBC)」を参照してください。