SQLDriverConnect

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

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

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

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

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

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

Укажите ключевое слово DRIVER или DSN. Драйвер ODBC использует крайнее левое из этих ключевых слов и пропускает другое, если указаны оба. Если параметр DRIVER указан или является крайней левой из двух, а SQLDriverConnect значение параметра DriverCompletion равно 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 для подключения к кластеру групп доступности Always On см. в разделе SQL Server Native Client поддержка высокого уровня доступности и аварийного восстановления.

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

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

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

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

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

Дополнительные сведения о именах субъектов-служб см. в разделе Имена субъектов-служб (SPN) статьи Клиентские подключения (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
ODBC API Implementation Details
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)