SQLGetDescRec

このトピックでは、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 から返されるデータを次に示します。

パラメーター

テーブル値パラメーター

テーブル値パラメーター列とその他のパラメーター

Name

ストアド プロシージャ呼び出しの場合は仮パラメーター名。それ以外の場合は長さが 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

date

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 ユーザー定義型 (ODBC)」を参照してください。

関連項目

概念

その他の技術情報