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 возвращает сведения обо всех серверах в домене.
.gif "Примечание") Примечание |
|---|
Из-за особенностей широковещания в сетях существует возможность того, что функция SQLBrowseConnect не получит своевременный ответ от всех серверов, и поэтому возвращаемый список серверов может меняться при каждом запросе. |
Поддержка функции SQLBrowseConnect для имен участников-служб (SPN)
При открытии соединения собственный клиент SQL Server задает SQL_COPT_SS_MUTUALLY_AUTHENTICATED и SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD метод проверки подлинности, используемый для открытия соединения.
Дополнительные сведения об именах участников-служб см. в разделе Имена участников-служб в клиентских запросах на установление соединения (ODBC).
См. также