Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Драйвер 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_NOCOUNT_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).
См. также
Основные понятия
Подробности реализации API-интерфейса ODBC