Поделиться через


SQLSetDescField

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

SQLSetDescField можно использовать для задания полей дескриптора для параметров с табличным значением и столбцов параметров табличного значения. Сведения о доступных полях см. в разделе "Поля дескриптора возвращающего табличное значение параметра" и "Дескриптор" для составных столбцов табличного параметра.

Замечания

Столбцы возвращающих табличное значение параметров доступны только в том случае, когда в поле заголовка дескриптора SQL_SOPT_SS_PARAM_FOCUS задан порядковый номер записи, имеющей тип SQL_DESC_TYPE со значением SQL_SS_TABLE. Дополнительные сведения об атрибуте SQL_SOPT_SS_PARAM_FOCUS см. в разделе SQLSetStmtAttr.

Если предпринята попытка задать SQL_SOPT_SS_PARAM_FOCUS порядковый номер параметра, который не является табличным параметром, SQLSetStmtAttr возвращает SQL_ERROR, а диагностическая запись создается с помощью SQLSTATE = HY024 и сообщение "Недопустимое значение атрибута". Если возвращается значение SQL_ERROR, то атрибут SQL_SOPT_SS_PARAM_FOCUS не меняется.

Установка атрибута SQL_SOPT_SS_PARAM_FOCUS в значение 0 восстанавливает доступ к записям дескриптора для параметров.

Дополнительные сведения о табличном значении параметров см. в разделе "Параметры с табличным значением" (ODBC).

Поддержка функцией SQLSetDescField улучшенных функций работы с данными в формате даты-времени

Функции работы с данными в формате даты-времени были расширены в ODBC. Сведения о поле дескриптора, предоставленном для новых типов даты и времени, см. в разделе "Параметры" и "Метаданные результата".

Дополнительные сведения см. в разделе "Улучшения даты и времени" (ODBC).

Поддержка функцией SQLSetDescField определяемых пользователем типов больших данных CLR

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

Поддержка функцией SQLSetDescField разреженных столбцов

SQLSetDecField можно использовать для задания SQL_SOPT_SS_NAME_SCOPE в дескрипторе параметра приложения (APD) значений SQL_SS_NAME_SCOPE_EXTENDED и SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET.

Дополнительные сведения см. в разделе "Поддержка разреженных столбцов( ODBC)".

См. также

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