SQLGetDescRec

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

このトピックでは、SQL Server Native Clientに固有の SQLGetDescRec 機能について説明します。

SQLGetDescRec とテーブル値パラメーター

SQLGetDescRec を使用して、テーブル値パラメーターとテーブル値パラメーター列の属性の値を取得できます。 SQLGetDescRec の RecNumber パラメーターは、SQLBindParameter の ParameterNumber パラメーターに対応します。

テーブル値パラメーター列は、記述子のヘッダー フィールド SQL_SOPT_SS_PARAM_FOCUS に、SQL_DESC_TYPE が SQL_SS_TABLE に設定されているレコードの序数が設定される場合のみ使用できます。 SQL_SOPT_SS_PARAM_FOCUSの詳細については、「 SQLSetStmtAttr」を参照してください。

SQLGetDescRec は、次のデータを返します。

パラメーター	テーブル値パラメーター	テーブル値パラメーター列とその他のパラメーター
名前	ストアド プロシージャ呼び出しの場合は仮パラメーター名。それ以外の場合は長さが 0 の文字列。	テーブル値パラメーター列の名前。
TypePtr	SQL_DESC_TYPE。 テーブル値パラメーターの場合、これは SQL_SS_TABLE です。	SQL_DESC_TYPE
SubTypePtr	未定義。	SQL_DESC_DATETIME_INTERVAL_CODE (SQL_DATETIME 型または SQL_INTERVAL 型のレコードの場合)。
LengthPtr	0	SQL_DESC_OCTET_LENGTH
PrecisionPtr	0	SQL_DESC_PRECISION
ScalePtr	0	SQL_DESC_SCALE
NullablePtr	1	SQL_DESC_NULLABLE

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

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

日付型または時刻型に対して返される値を次に示します。

属性	TypePtr	SubTypePtr	LengthPtr	PrecisionPtr	ScalePtr
DATETIME	SQL_DATETIME	SQL_CODE_TIMESTAMP	4	3	3
smalldatetime	SQL_DATETIME	SQL_CODE_TIMESTAMP	8	0	0
日付	SQL_DATETIME	SQL_CODE_DATE	6	0	0
time	SQL_SS_TIME2	0	10	0..7	0..7
datetime2	SQL_DATETIME	SQL_CODE_TIMESTAMP	16	0..7	0..7
datetimeoffset	SQL_SS_TIMESTAMPOFFSET	0	20	0..7	0..7

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

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

SQLGetDescRec では 、大きな CLR ユーザー定義型 (UDT) がサポートされています。 詳細については、「 大きな CLR User-Defined型 (ODBC)」を参照してください。

参照

SQLGetDescRec
ODBC API 実装の詳細