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


SQLGetConnectAttr

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

В этом разделе приведены атрибуты режима только для чтения. Сведения о других SQL Server Native Client атрибутах подключения для драйвера ODBC см. в разделе 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 еще не задан, возвращается значение по умолчанию (пустая строка).

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

См. также:

Функция SQLGetConnectAttr
ODBC API Implementation Details
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)