• Статья

SQLGetConnectAttr

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

Дополнительные сведения об атрибутах см. в разделе 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_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).