Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
SQLBrowseConnect использует ключевые слова, которые можно разделить на три уровня сведений о подключении. Для каждого ключевого слова в следующей таблице указывается, возвращается ли список допустимых значений и является ли ключевое слово необязательным.
Уровень 1
| Ключевое слово | Возвращен список? | Является необязательным? | Описание |
|---|---|---|---|
| DSN | Не применимо | нет | Имя источника данных, возвращаемого SQLDataSources. Ключевое слово DSN нельзя использовать, если используется ключевое слово DRIVER. |
| ВОДИТЕЛЬ | Не применимо | нет | Microsoft?? Имя драйвера ODBC собственного клиента SQL Server — {SQL Server Native Client 11}. Ключевое слово DRIVER нельзя использовать, если используется ключевое слово DSN. |
Уровень 2
| Ключевое слово | Возвращен список? | Является необязательным? | Описание |
|---|---|---|---|
| СЕРВЕР | Да | нет | Имя сервера в сети, в которой находится источник данных. Термин "(local)" можно ввести как сервер, в этом случае можно использовать локальную копию SQL Server, даже если это не сетевая версия. |
| Уникальный идентификатор | нет | Да | Идентификатор входа пользователя. |
| PWD | нет | Да (зависит от пользователя) | Указанный пользователем пароль. |
| ПРИЛОЖЕНИЕ | нет | Да | Имя приложения, вызывающего SQLBrowseConnect. |
| WSID | нет | Да | Идентификатор рабочей станции. Как правило, это сетевое имя компьютера, на котором выполняется приложение. |
Уровень 3
| Ключевое слово | Возвращен список? | Является необязательным? | Описание |
|---|---|---|---|
| База данных | Да | Да | Имя базы данных SQL Server. |
| ЯЗЫК | Да | Да | Национальный язык, используемый 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:ServerName\InstanceName; Кластеризовано:Нет; Версия:8.00.131 В этой строке точка с запятой отделяет различные фрагменты информации о сервере. Используйте запятые для разделения разных экземпляров сервера. |
| SQL_COPT_SS_BROWSE_SERVER | Если указано имя сервера, SQLBrowseConnect вернет сведения для указанного сервера. Если SQL_COPT_SS_BROWSE_SERVER имеет значение NULL, SQLBrowseConnect возвращает сведения для всех серверов в домене. Из-за проблем с сетью 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 Native Client Support for High Availability, Аварийное восстановление.
Поддержка SQLBrowseConnect для имен субъектов-служб (SPN)
При открытии подключения собственный клиент SQL Server задает SQL_COPT_SS_MUTUALLY_AUTHENTICATED и SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD методу проверки подлинности, используемому для открытия подключения.
Дополнительные сведения о именах субъектов-служб см. в разделе "Имена субъектов-служб" в клиентских подключениях (ODBC).
История изменений
| Обновленное содержимое |
|---|
| Документированные SQL_COPT_SS_BROWSE_CACHE_DATA. |
См. также
Функция SQLBrowseConnect
Подробные сведения о реализации API-интерфейсов ODBC