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).
См. также