SQLBrowseConnect
Функция SQLBrowseConnect использует ключевые слова, которые можно разделить на три категории по уровням сведений о соединении. Для каждого ключевого слова в следующей таблице указано, возвращается ли список допустимых значений и является ли ключевое слово необязательным.
Уровень 1
Ключевое слово |
Возвращает список? |
Является необязательным? |
Описание |
|---|---|---|---|
DSN |
Недоступно |
Нет |
Имя источника данных, возвращаемое функцией SQLDataSources. Ключевое слово DSN нельзя использовать, если используется ключевое слово DRIVER. |
DRIVER |
Недоступно |
Нет |
Имя драйвера ODBC для собственного клиента Microsoft® SQL Server — {SQL Server Native Client 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. В этой строке различные порции данных о сервере разделяются точками с запятой. Для разделения различных экземпляров сервера используйте запятые. |
SQL_COPT_SS_BROWSE_SERVER |
Если указано имя сервера, функция SQLBrowseConnect возвращает сведения об указанном сервере. Если для SQL_COPT_SS_BROWSE_SERVER задано значение NULL, функция SQLBrowseConnect возвращает сведения обо всех серверах в домене. .gif "Примечание") Примечание
Из-за проблем с сетью функция 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 для имен участников-служб
При открытии соединения собственный клиент Native Client SQL Server задает метод проверки подлинности (SQL_COPT_SS_MUTUALLY_AUTHENTICATED и SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD), используемый для открытия соединения.
Дополнительные сведения об именах участников-служб см. в разделе Имена участников-служб в клиентских запросах на установление соединения (ODBC).
См. также