SQLGetConnectAttr
Применимо: 
SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)
Драйвер 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).
См. также
Функция SQLGetConnectAttr
Подробные сведения о реализации API-интерфейсов ODBC
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)