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

SQLGetConnectAttr

  • Статья

Драйвер ODBC собственного клиента SQL Server определяет характерные для драйвера атрибуты соединения. Некоторые из этих атрибутов доступны для функции SQLGetConnectAttr, а сама функция используется для определения их текущих значений. Нельзя быть уверенным в правильности значений этих атрибутов, сообщаемых функцией, до тех пор, пока не будет установлено соединение или атрибут не будет задан при помощи функции SQLSetConnectAttr.

В этом разделе приведены атрибуты режима только для чтения. Сведения о других атрибутах подключения, относящихся к драйверу поставщика ODBC собственного клиента SQL Server, см. в разделе SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

Атрибут SQL_COPT_SS_CONNECTION_DEAD сообщает серверу данные о состоянии соединения. Для определения текущего состояния соединения драйвер запрашивает сеть.

ПримечаниеПримечание

Стандартный атрибут соединения ODBC SQL_ATTR_CONNECTION_DEAD возвращает последнее по времени состояние соединения. Может оказаться так, что это состояние соединения будет отличаться от текущего.

Значение

Описание

SQL_CD_TRUE

Соединение с сервером потеряно.

SQL_CD_FALSE

Соединение открыто и доступно для обработки инструкций.

SQL_COPT_SS_CLIENT_CONNECTION_ID

Атрибут SQL_COPT_SS_CLIENT_CONNECTION_ID извлекает идентификатор соединения клиента, по которому затем производится поиск и обнаружение следующих данных.

  • Диагностические сведения в журнале XEvents, если он включен.

  • Сведения об ошибке соединения в кольцевом буфере соединения.

  • Диагностические сведения в журналах отслеживания доступа к данным, если они включены.

Дополнительные сведения см. в разделе Доступ к диагностическим сведениям в журнале расширенных событий.

Значение

Описание

SQL_ERROR

Ошибка соединения.

SQL_SUCCESS

Подключение выполнено успешно. Идентификатор соединения клиента будет находиться в выходном буфере.

SQL_COPT_SS_PERF_DATA

Атрибут SQL_COPT_SS_PERF_DATA возвращает указатель на структуру SQLPERF, содержащую текущую статистику производительности драйвера. Если ведение журнала производительности не включено, функция SQLGetConnectAttr возвращает значение NULL. Драйвер не обновляет статистику в структуре SQLPERF динамически. Каждый раз, когда возникает необходимость обновить статистику производительности, вызывайте функцию SQLGetConnectAttr.

Значение

Описание

NULL

Ведение журнала производительности не включено.

Любое другое значение

Указатель на структуру SQLPERF.

SQL_COPT_SS_PERF_QUERY

Если запись в журнал данных о длительных запросах включена, то атрибут SQL_COPT_SS_PERF_QUERY возвращает значение TRUE. Если запись в журнал данных о запросах неактивна, этот атрибут возвращает значение FALSE.

SQL_COPT_SS_USER_DATA

Атрибут SQL_COPT_SS_USER_DATA извлекает указатель на данные пользователя. Пользовательские данные хранятся в принадлежащей клиенту памяти и записываются отдельно для каждого соединения. Если указатель на данные пользователя на задан, что соответствует значению SQL_UD_NOTSET, то возвращается указатель NULL.

Значение

Описание

SQL_UD_NOTSET

Указатель на данные пользователя не задан.

Любое другое значение

Указатель на данные пользователя.

Поддержка функции SQLGetConnectAttr для имен участников-служб (SPN)

При помощи функции SQLGetConnectAttr можно запрашивать значения новых атрибутов соединения SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED и SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (Запросить эти значения можно также при помощи функции SQLGetConnectOption.)

Атрибут SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD доступен только для открытых соединений, в которых используется проверка подлинности Windows.

Если атрибут SQL_COPT_SS_SERVER_SPN или SQL_COPT_SS_FAILOVER_PARTNER еще не задан, возвращается значение по умолчанию (пустая строка).

Дополнительные сведения об именах участников-служб см. в разделе Имена участника-службы в клиентских соединениях (ODBC).

См. также

Справочник

SET QUOTED_IDENTIFIER (Transact-SQL)

SET ANSI_NULLS (Transact-SQL)

SET ANSI_PADDING (Transact-SQL)

SET ANSI_WARNINGS (Transact-SQL)

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

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

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

Функция SQLGetConnectAttr