SQLDriverConnect

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

SQLDriver Подключение примет новые строка подключения ключевое слово s 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 методу проверки подлинности, используемому для открытия подключения.

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

Примеры

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

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)