Поделиться через


SQLBrowseConnect

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

Уровень 1

Ключевое слово

Возвращает список?

Является необязательным?

Описание

DSN

Недоступно

Нет

Имя источника данных, возвращаемое SQLDataSources. Ключевое слово DSN нельзя использовать, если используется ключевое слово DRIVER.

DRIVER

Недоступно

Нет

Имя драйвера ODBC для собственного клиента Microsoft® SQL Server: {собственный клиент SQL Server 10}. Ключевое слово 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, в SQL Server 2000 и более поздних версиях функция SQLBrowseConnect возвращает расширенную строку свойств сервера.

Ниже приведен пример расширенной строки, возвращаемой функцией SQLBrowseConnect в SQL Server 2000.

ServerName\InstanceName;Clustered:No;Version:8.00.131

В этой строке точки с запятой разделяют части сведений о сервере, а запятые разделяют экземпляры сервера.

SQL_COPT_SS_BROWSE_SERVER: Если указано имя сервера, функция SQLBrowseConnect возвращает сведения об указанном сервере. Если для SQL_COPT_SS_BROWSE_SERVER задано значение NULL, функция SQLBrowseConnect возвращает сведения обо всех серверах в домене.

ПримечаниеПримечание

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

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

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

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

См. также

Основные понятия

Другие ресурсы