SQLBrowseConnect

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

SQLBrowseConnect использует ключевые слова, которые можно разделить на три уровня сведений о подключении. Для каждого ключевого слова в следующей таблице указано, возвращается ли список допустимых значений и является ли ключевое слово необязательным.

Уровень 1

Ключевое слово	Возвращает список?	Является необязательным?	Description
DSN	Н/П	No	Имя источника данных, возвращаемого SQLDataSources. Ключевое слово DSN нельзя использовать, если используется ключевое слово DRIVER.
DRIVER	Н/П	No	Имя драйвера ODBC собственного клиента SQL Server — {SQL Server Native Client 11}. Ключевое слово DRIVER нельзя использовать, если используется ключевое слово DSN.

Уровень 2

Ключевое слово	Возвращает список?	Является необязательным?	Description
СЕРВЕР	Да	Нет	Имя сервера источника данных в сети. Термин "(local)" можно ввести как сервер, в этом случае можно использовать локальную копию SQL Server, даже если это не сетевая версия.
ИД пользователя	No	Да	Идентификатор входа пользователя.
PWD	No	Да (зависит от пользователя)	Определяемый пользователем пароль.
ПРИЛОЖЕНИЕ	No	Да	Имя приложения, вызывающего SQLBrowseConnect.
WSID	No	Да	Идентификатор рабочей станции. Обычно это сетевое имя компьютера, на котором работает приложение.

Уровень 3

Ключевое слово	Возвращает список?	Является необязательным?	Description
DATABASE	Да	Да	Имя базы данных SQL Server.
ПРОГРАММИРОВАНИЯ	Да	Да	Национальный язык, используемый SQL Server.

SQLBrowseConnect игнорирует значения ключевых слов DATABASE и LANGUAGE, хранящихся в определениях источников данных ODBC. Если база данных или язык, указанный в строка подключения, переданной в SQLBrowseConnect, недопустим, SQLBrowseConnect возвращает SQL_NEED_DATA и атрибуты подключения уровня 3.

Следующие атрибуты, которые задаются путем вызова SQLSetConnectAttr, определяют результирующий набор, возвращаемый SQLBrowseConnect.

Атрибут	Description
SQL_COPT_SS_BROWSE_CONNECT	Если для него задано значение SQL_MORE_INFO_YES, SQLBrowseConnect возвращает расширенную строку свойств сервера. Ниже приведен пример расширенной строки, возвращаемой SQLBrowseConnect: ServerName\InstanceName;Clustered:No;Version:8.00.131 В этой строке различные порции данных о сервере разделяются точками с запятой. Для разделения различных экземпляров сервера используйте запятые.
SQL_COPT_SS_BROWSE_SERVER	Если указано имя сервера, SQLBrowseConnect вернет сведения для указанного сервера. Если SQL_COPT_SS_BROWSE_SERVER имеет значение NULL, SQLBrowseConnect возвращает сведения для всех серверов в домене. Обратите внимание, что из-за проблем с сетью SQLBrowseConnect может не получать своевременный ответ со всех серверов. Поэтому возвращаемый список серверов может отличаться от запроса к запросу.
SQL_COPT_SS_BROWSE_CACHE_DATA	Если атрибут SQL_COPT_SS_BROWSE_CACHE_DATA имеет значение SQL_CACHE_DATA_YES, то в случае, когда длина буфера недостаточна для размещения результата, можно получать данные фрагментами. Эта длина указана в аргументе BufferLength в SQLBrowseConnect. Если доступны дополнительные данные, возвращается значение SQL_NEED_DATA. Если нет неполученных данных, возвращается значение SQL_SUCCESS. По умолчанию задано значение SQL_CACHE_DATA_NO.

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

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

Поддержка функции SQLBrowseConnect для имен участников-служб

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

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

Журнал изменений

Обновленное содержимое
Добавлена документация по SQL_COPT_SS_BROWSE_CACHE_DATA.

См. также

Функция SQLBrowseConnect
Подробные сведения о реализации API-интерфейсов ODBC