SQLGetDescRec
Применимо:
SQL Server База данных SQL Azure Управляемый экземпляр SQL Azureazure 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 |
| Дата | 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