SQLBrowseConnect
Функция SQLBrowseConnect использует ключевые слова, которые можно разделить на три категории по уровням сведений о соединении. Для каждого ключевого слова в следующей таблице указано, возвращается ли список допустимых значений и является ли ключевое слово необязательным.
Уровень 1
Ключевое слово |
Возвращает список? |
Является необязательным? |
Описание |
---|---|---|---|
DSN |
н/д |
Нет |
Имя источника данных, возвращаемое функцией SQLDataSources. Ключевое слово DSN нельзя использовать, если используется ключевое слово DRIVER. |
DRIVER |
Недоступно |
Нет |
Имя драйвера ODBC для собственного клиента Microsoft® SQL Server — {SQL Server Native Client 11}. Ключевое слово DRIVER нельзя использовать, если используется ключевое слово DSN. |
Уровень 2
Ключевое слово |
Возвращает список? |
Является необязательным? |
Описание |
---|---|---|---|
SERVER |
Да |
Нет |
Имя сервера источника данных в сети. В качестве сервера можно ввести термин «(local)»; в этом случае можно использовать локальную копию SQL Server, даже если это не сетевая версия. |
UID |
Нет |
Да |
Идентификатор входа пользователя. |
PWD |
Нет |
Да (зависит от пользователя) |
Определяемый пользователем пароль. |
APP |
Нет |
Да |
Имя приложения, вызывающего функцию SQLBrowseConnect. |
WSID |
Нет |
Да |
Идентификатор рабочей станции. Обычно это сетевое имя компьютера, на котором работает приложение. |
Уровень 3
Ключевое слово |
Возвращает список? |
Является необязательным? |
Описание |
---|---|---|---|
DATABASE |
Да |
Да |
Имя базы данных SQL Server. |
LANGUAGE |
Да |
Да |
Национальный язык, используемый SQL Server. |
Функция SQLBrowseConnect не учитывает значения ключевых слов DATABASE и LANGUAGE, хранящиеся в определениях источника данных ODBC. Если в строке соединения, передаваемой функции SQLBrowseConnect, указаны недопустимые база данных или язык, функция SQLBrowseConnect возвращает SQL_NEED_DATA и атрибуты соединения уровня 3.
Следующие атрибуты, задаваемые путем вызова функции SQLSetConnectAttr, определяют результирующий набор, возвращаемый функцией SQLBrowseConnect.
Атрибут |
Описание |
||
---|---|---|---|
SQL_COPT_SS_BROWSE_CONNECT |
Если установлено значение SQL_MORE_INFO_YES, то функция SQLBrowseConnect возвращает расширенную строку свойств сервера. Ниже приведен пример расширенной строки, возвращаемой функцией SQLBrowseConnect.
В этой строке различные порции данных о сервере разделяются точками с запятой. Для разделения различных экземпляров сервера используйте запятые. |
||
SQL_COPT_SS_BROWSE_SERVER |
Если указано имя сервера, функция SQLBrowseConnect возвращает сведения об указанном сервере. Если для SQL_COPT_SS_BROWSE_SERVER задано значение NULL, функция 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.
Поддержка функции SQLBrowseConnect для имен участников-служб
При открытии соединения собственный клиент SQL Server задает SQL_COPT_SS_MUTUALLY_AUTHENTICATED и SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD метод проверки подлинности, используемый для открытия соединения.
Дополнительные сведения об именах участников-служб см. в разделе Имена участника-службы в клиентских соединениях (ODBC).
См. также
Основные понятия
Подробности реализации API-интерфейса ODBC
Другие ресурсы
Журнал изменений
Обновленное содержимое |
---|
Добавлена документация по SQL_COPT_SS_BROWSE_CACHE_DATA. |