SQLSetDescField

適用対象: SQL Server Azure SQL Database 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)」を参照してください。

参照

SQLSetDescField
ODBC API 実装の詳細