SQLDriverConnect

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Драйвер ODBC собственного клиента SQL Server определяет атрибуты подключения, которые заменяют или улучшают ключевые слова строки подключения. Несколько ключевых слов строки подключения имеют значения по умолчанию, заданные драйвером ODBC собственного клиента SQL Server.

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

Дополнительные сведения об атрибутах подключения SQL Server и поведении драйверов по умолчанию см. в статье SQLSetConnectAttr.

Обсуждение ключевых слов строка подключения, допустимых для собственного клиента SQL Server, см. в разделе "Использование ключевых слов строки подключения" с собственным клиентом SQL Server.

Если значение параметра DriverCompletion SQLDriverConnectSQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE или SQL_DRIVER_COMPLETE_REQUIRED, драйвер ODBC собственного клиента SQL Server извлекает значения ключевых слов из отображаемого диалогового окна. Если значение ключевого слова передается в строка подключения, а пользователь не изменяет значение ключевого слова в диалоговом окне, драйвер ODBC собственного клиента SQL Server использует значение из строка подключения. Если значение не определено в строке соединения, а пользователь не присваивает его в диалоговом окне, драйвер использует значение по умолчанию.

SQLDriverConnect должен быть указан допустимый параметр WindowHandle , если любое значение DriverCompletion требует (или может потребоваться) в диалоговом окне подключения драйвера. Недопустимый дескриптор возвращает ошибку SQL_ERROR.

Укажите ключевое слово DRIVER или DSN. Драйвер ODBC использует крайнее левое из этих ключевых слов и пропускает другое, если указаны оба. Если драйвер указан или является самым левым из двух, а значение параметра DriverCompletion SQLDriverConnectравно SQL_DRIVER_NOPROMPT, необходимо ключевое слово SERVER и соответствующее значение.

Если задано значение SQL_DRIVER_NOPROMPT, необходимо указать ключевые слова проверки подлинности пользователя вместе с их значениями. Драйвер обеспечивает наличие строки «Trusted_Connection=yes» или обоих ключевых слов UID и PWD.

Если значение параметра DriverCompletion SQL_DRIVER_NOPROMPT или SQL_DRIVER_COMPLETE_REQUIRED, а язык или база данных поступает из строка подключения и либо является недопустимым, SQLDriverConnect возвращает SQL_ERROR.

Если значение параметра DriverCompletion SQL_DRIVER_NOPROMPT или SQL_DRIVER_COMPLETE_REQUIRED, а язык или база данных поступает из определений источников данных ODBC, а SQLDriverConnect использует язык по умолчанию или базу данных для указанного идентификатора пользователя и возвращает SQL_SUCCESS_WITH_INFO.

Если значение параметра DriverCompletion SQL_DRIVER_COMPLETE или SQL_DRIVER_PROMPT, а если язык или база данных недопустима, SQLDriverConnect переиграет диалоговое окно.

Поддержка высокого уровня доступности и аварийного восстановления SQLDriverConnect

Дополнительные сведения об использовании SQLDriverConnect для подключения к кластеру групп доступности AlwaysOn см. в статье SQL Server Native Client Support for High Availability, Аварийное восстановление.

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

SQLDDriverConnect будет использовать диалоговое окно "Вход ODBC" включено. Это позволяет ввести имена участников-служб как для основного сервера, так и для его партнера по обеспечению отработки отказа.

SQLDriverConnect примет новые ключевые слова строка подключения ServerSPN и FailoverPartnerSPN, и распознает новые атрибуты подключения SQL_COPT_SS_SERVER_SPN и SQL_COPT_SS_FAILOVER_PARTNER_SPN.

Если значение атрибута соединения задано более одного раза, приоритет получает программно установленное значение, а не значение в DSN или строке соединения. Значение DSN имеет приоритет над значением в строке соединения.

При открытии подключения собственный клиент SQL Server задает SQL_COPT_SS_MUTUALLY_AUTHENTICATED и SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD методу проверки подлинности, используемому для открытия подключения.

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

Примеры

Следующий вызов иллюстрирует наименьший объем данных, необходимых для SQLDriverConnect:

SQLDriverConnect(hdbc, hwnd,  
    (SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,  
    MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);  

Следующие строка подключения иллюстрируют минимальные обязательные данные, если значение параметра DriverCompletion SQL_DRIVER_NOPROMPT:

"DSN=Human Resources;Trusted_Connection=yes"  
  
"FILEDSN=HR_FDSN;Trusted_Connection=yes"  
  
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"  

См. также

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