SQLGetDescRec

Применимо к:SQL ServerAzure SQL DatabaseAzure Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

В этом разделе рассматриваются функции SQLGetDescRec, относящиеся к собственному клиенту SQL Server.

Функция SQLGetDescRec и возвращающие табличные значения параметры

SQLGetDescRec можно использовать для получения значений атрибутов табличных параметров и столбцов возвращаемых табличным значением параметров. Параметр RecNumber sqlGetDescRec соответствует параметру ParameterNumber SQLBindParameter.

Столбцы возвращающих табличное значение параметров доступны только в том случае, когда в поле заголовка дескриптора 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	Undefined	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
Время	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 больших определяемых пользователем типов (UDT) среды CLR

SQLGetDescRec поддерживает большие определяемые пользователем типы CLR (определяемые пользователем UDTs). Дополнительные сведения см. в разделе "Крупные определяемые пользователем типы CLR" (ODBC).

См. также

SQLGetDescRec
Подробные сведения о реализации API-интерфейсов ODBC