SQLBrowseConnect

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

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

Уровень 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	Да	Имя приложения, вызывающего SQLBrowse Подключение.
WSID	No	Да	Идентификатор рабочей станции. Обычно это сетевое имя компьютера, на котором работает приложение.

Уровень 3

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

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

Следующие атрибуты, которые задаются путем вызова SQLSet Подключение Attr, определяют результирующий набор, возвращаемый SQLBrowse Подключение.

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

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

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

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

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

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

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

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

См. также

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