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 статистики производительности необходимо обновить.

Ценность Описание
Отсутствует Ведение журнала производительности не включено.
Любое другое значение Указатель на структуру 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).

См. также

Функция SQLGetConnectAttr
Подробные сведения о реализации API-интерфейсов ODBC
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)

  • Last updated on