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


SQLGetStmtAttr

Драйвер ODBC собственного клиента SQL Server расширяет SQLGetStmtAttr для предоставления атрибутов инструкции, специфичных для драйвера.

Функция SQLSetStmtAttr перечисляет атрибуты инструкции, которые можно как считывать, так и изменять. В данном разделе приводятся атрибуты инструкции только для чтения.

SQL_SOPT_SS_CURRENT_COMMAND

Атрибут SQL_SOPT_SS_CURRENT_COMMAND предоставляет текущую команду пакета команд. Возвращение является целым числом, указывающим расположение команды в пакете. Значение аргумента ValuePtr имеет тип SQLLEN.

SQL_SOPT_SS_NOCOUNT_STATUS

Атрибут SQL_SOPT_SS_NCOUNT_STATUS указывает на текущую установку параметра NOCOUNT, который управляет формированием отчета SQL Server о числе строк, затронутых инструкцией при вызове SQLRowCount. Значение аргумента ValuePtr имеет тип SQLLEN.

Значение

Описание

SQL_NC_OFF

Значение NOCOUNT — OFF. SQLRowCount возвращает число затронутых строк.

SQL_NC_ON

Значение NOCOUNT — ON. Число затронутых строк не возвращается с помощью SQLRowCount, и возвращаемое значение равно 0.

Если SQLRowCount возвращает 0, то приложение должно проверить SQL_SOPT_SS_NOCOUNT_STATUS. Если возвращается SQL_NC_ON, значение 0 от SQLRowCount определяет только то, что SQL Server не вернул количество строк. Если возвращается SQL_NC_OFF, это значит, что NOCOUNT отключен и значение 0 от SQLRowCount указывает, что инструкция не затронула ни одной строки.

Приложения не должны отображать значение SQLRowCount, когда SQL_SOPT_SS_NOCOUNT_STATUS установлен в значение SQL_NC_OFF. Большие пакеты или хранимые процедуры могут содержать несколько инструкций SET NOCOUNT, следовательно, нельзя предположить, что SQL_SOPT_SS_NOCOUNT_STATUS остается неизменным. Данный параметр необходимо проверять каждый раз, когда функция SQLRowCount возвращает 0.

Атрибут SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT

Атрибут SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT возвращает текст сообщения в ответ на запрошенное уведомление о запросе.

SQLGetStmtAttr и возвращающие табличное значение параметры

SQLGetStmtAttr может быть вызван для получения значения SQL_SOPT_SS_PARAM_FOCUS в дескрипторе параметра приложения (APD) при работе с возвращающими табличное значение параметрами. Дополнительные сведения о SQL_SOPT_SS_PARAM_FOCUS см. в разделе SQLSetStmtAttr.

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

См. также

Основные понятия

Другие ресурсы