Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этом разделе рассматриваются функции SQLSetDescRec, относящиеся к собственному клиенту SQL Server.
Параметры SQLSetDescRec и Table-Valued
SQLSetDescRec можно использовать для задания полей дескриптора для параметров с табличным значением и столбцов возвращаемых табличным значением параметров. Столбцы возвращающих табличное значение параметров доступны только в том случае, когда в поле заголовка дескриптора SQL_SOPT_SS_PARAM_FOCUS задан порядковый номер записи, имеющей тип SQL_DESC_TYPE со значением SQL_SS_TABLE. Дополнительные сведения о SQL_SOPT_SS_PARAM_FOCUS см. в разделе SQLSetStmtAttr.
В следующей таблице описывается сопоставление между параметрами и полями дескриптора.
| Параметр | Связанный атрибут для типов параметров, отличных от табличного значения, включая столбцы параметров с табличным значением | Связанный атрибут для параметров с табличным значением |
|---|---|---|
| Тип | SQL_DESC_TYPE | SQL_SS_TABLE |
| Подтип | Проигнорировано | Для записей типа SQL_DATETIME или SQL_INTERVAL задайте для этого значение SQL_DESC_DATETIME_INTERVAL_CODE. |
| Длина | SQL_DESC_OCTET_LENGTH | Длина имени типа параметра с табличным значением. Это может быть SQL_NTS, если имя типа завершается null, или ноль, если имя типа с табличным значением не требуется. |
| Точность | SQL_DESC_PRECISION | SQL_DESC_ARRAY_SIZE |
| Масштабировать | SQL_DESC_SCALE | Неиспользованный. Этот параметр должен быть равен нулю. |
| DataPtr | SQL_DESC_DATA_PTR в APD | SQL_CA_SS_TYPE_NAME Этот параметр является необязательным для вызовов хранимой процедуры, и значение NULL можно указать, если это не требуется. Этот параметр должен быть указан для инструкций SQL, которые не являются вызовами процедур. DataPtr также служит уникальным значением, которое приложение может использовать для идентификации этого табличного параметра при использовании привязки строк переменной. |
| StringLengthPtr | SQL_DESC_OCTET_LENGTH_PTR | SQL_DESC_OCTET_LENGTH_PTR Для табличного параметра это число строк для передачи или SQL_DATA_AT_EXEC. Это указатель на значение, которое содержит количество строк для передачи с помощью SQLExecDirect. |
| индикатора |
SQL_DESC_INDICATOR_PTR | SQL_DESC_INDICATOR_PTR |
Дополнительные сведения о табличном значении параметров см. в разделе "Параметры с табличным значением" (ODBC).
Поддержка SQLSetDescRec для расширенных функций даты и времени
Значения, допустимые для типов даты и времени, приведены следующим образом:
| Тип | Подтип | Длина | Точность | Масштабировать | |
|---|---|---|---|---|---|
| дата/время | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | SQL_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 |
| дата-время2 | SQL_DATETIME | SQL_CODE_TIMESTAMP | 16 | 0..7 | 0..7 |
| смещение даты и времени | SQL_SS_TIMESTAMPOFFSET | 0 | 20 | 0..7 | 0..7 |
Дополнительные сведения см. в разделе "Улучшения даты и времени" (ODBC).
Поддержка SQLSetDescRec для больших определяемых пользователем UDR
SQLSetDescRec поддерживает большие определяемые пользователем типы СРЕДЫ CLR (определяемые пользователем UDT). Дополнительные сведения см. в разделе "Крупные определяемые пользователем типы CLR" (ODBC).
См. также
SQLSetDescRec
Подробные сведения о реализации API-интерфейсов ODBC