SQLSetDescField

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

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 とメッセージ "Invalid attribute value" を使用して診断レコードが作成されます。 SQL_SOPT_SS_PARAM_FOCUS は、SQL_ERROR が返されたときに変更されません。

SQL_SOPT_SS_PARAM_FOCUS に 0 を設定すると、パラメーターの記述子レコードへのアクセスが復元されます。

テーブル値パラメーターの詳細については、「 テーブル値パラメーター (ODBC)」を参照してください。

SQLSetDescField による機能強化された日付と時刻のサポート

ODBC では、日付と時刻の機能が強化されました。 新しい日付/時刻型に対して提供される記述子フィールドの詳細については、「 パラメーターと結果メタデータ」を参照してください。

詳細については、「 日付と時刻の機能強化 (ODBC)」を参照してください。

SQLSetDescField による大きな CLR UDT のサポート

SQLSetDescField では、大きな CLR ユーザー定義型 (UDT) がサポートされています。 詳細については、「 大きな CLR User-Defined型 (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 実装の詳細