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)」を参照してください。