SQLSetDescFieldSQLSetDescField

適用対象: ○SQL Server ○Azure SQL Database ○Azure SQL Data Warehouse ○Parallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Sqlsetdescfield によるは、テーブル値パラメーターおよびテーブル値パラメーター列の記述子フィールドを設定するのには使用できます。SQLSetDescField can be used to set descriptor fields for table-valued parameters and table-valued parameter columns. 使用可能なフィールドの詳細については、次を参照してください。テーブル値パラメーターの記述子フィールドテーブル値パラメーターの構成要素の列の記述子フィールドします。For information about the available fields, see Table-Valued Parameter Descriptor Fields and Descriptor Fields for Table-Valued Parameter Constituent Columns.

コメントRemarks

テーブル値パラメーター列は、記述子のヘッダー フィールド SQL_SOPT_SS_PARAM_FOCUS に、SQL_DESC_TYPE が SQL_SS_TABLE に設定されているレコードの序数が設定される場合のみ使用できます。Table-valued parameter columns are only available when the descriptor header field SQL_SOPT_SS_PARAM_FOCUS is set to the ordinal of a record that has SQL_DESC_TYPE set to SQL_SS_TABLE. SQL_SOPT_SS_PARAM_FOCUS の詳細については、次を参照してください。 SQLSetStmtAttrします。For more information about SQL_SOPT_SS_PARAM_FOCUS, see SQLSetStmtAttr.

テーブル値パラメーターのないパラメーターの序数に SQL_SOPT_SS_PARAM_FOCUS を設定しようとしましたが、SQLSetStmtAttr が、SQL_ERROR を返し、sqlstate 診断レコードが作成された場合は、HY024 とメッセージ「無効な属性値」を = します。If an attempt is made to set SQL_SOPT_SS_PARAM_FOCUS to the ordinal of a parameter that is not a table-valued parameter, SQLSetStmtAttr returns SQL_ERROR, and a diagnostic record is created with SQLSTATE = HY024 and the message "Invalid attribute value". SQL_SOPT_SS_PARAM_FOCUS は、SQL_ERROR が返されたときに変更されません。SQL_SOPT_SS_PARAM_FOCUS is not changed when SQL_ERROR is returned.

SQL_SOPT_SS_PARAM_FOCUS に 0 を設定すると、パラメーターの記述子レコードへのアクセスが復元されます。Setting SQL_SOPT_SS_PARAM_FOCUS to 0 restores access to descriptor records for parameters.

テーブル値パラメーターの詳細については、次を参照してください。テーブル値パラメーター (ODBC)します。For more information about table-valued parameters, see Table-Valued Parameters (ODBC).

SQLSetDescField による機能強化された日付と時刻のサポートSQLSetDescField Support for Enhanced Date and Time Features

ODBC では、日付と時刻の機能が強化されました。Date/time features have been enhanced in ODBC. 新しい日付/時刻型の指定された記述子フィールドについては、次を参照してください。パラメーターと結果のメタデータします。For information about the descriptor field provided for the new date/time types, see Parameter and Result Metadata.

詳細については、次を参照してください。日付と時刻の強化(ODBC)します。For more information, see Date and Time Improvements (ODBC).

SQLSetDescField による大きな CLR UDT のサポートSQLSetDescField Support for Large CLR UDTs

Sqlsetdescfield による大きなの CLR ユーザー定義型 (Udt) をサポートしています。SQLSetDescField supports large CLR user-defined types (UDTs). 詳細については、次を参照してください。 Large CLR User-Defined 型(ODBC)します。For more information, see Large CLR User-Defined Types (ODBC).

SQLSetDescField によるスパース列のサポートSQLSetDescField Support for Sparse Columns

SQLSetDecField sql_sopt_ss_name_scope を SQL_SS_NAME_SCOPE_EXTENDED および SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET 値にアプリケーション パラメーター記述子 (APD) を使用できます。SQLSetDecField can be used to set SQL_SOPT_SS_NAME_SCOPE in the application parameter descriptor (APD) to the values SQL_SS_NAME_SCOPE_EXTENDED and SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET.

詳細については、次を参照してください。スパース列のサポート(ODBC)します。For more information, see Sparse Columns Support (ODBC).

参照See Also

Sqlsetdescfield による SQLSetDescField
ODBC API 実装の詳細ODBC API Implementation Details