Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
SQLBrowseConnect, например SQLDriverConnect, использует строку подключения. Однако с помощью SQLBrowseConnect приложение может создать полную строку подключения во время выполнения. Это позволяет приложению выполнять две действия:
Создайте собственные диалоговые окна, чтобы запрашивать эту информацию, тем самым сохраняя контроль над своим "внешним видом и ощущением".
Просмотрите систему в поисках источников данных, которые могут быть использованы определенным драйвером, возможно, в несколько этапов. Например, пользователь может сначала просмотреть сеть в поисках серверов, а затем, выбрав сервер, просмотреть сервер на наличие баз данных, доступных для драйвера.
Приложение вызывает SQLBrowseConnect и передает строку подключения, известную как строка подключения запроса обзора, указывающая драйвер или источник данных. Драйвер возвращает строку подключения, известную как строка подключения результатов обзора, содержащую ключевые слова, возможные значения (если ключевое слово принимает дискретный набор значений) и удобочитаемые имена. Приложение создает диалоговое окно с понятными именами и запрашивает у пользователя значения. Затем он формирует новую строку подключения для запроса обзора на основе этих значений и возвращает её драйверу с помощью другого вызова SQLBrowseConnect.
Так как строки подключения передаются обратно и вперед, драйвер может предоставить несколько уровней просмотра, возвращая новую строку подключения, когда приложение возвращает старое. Например, при первом вызове приложения SQLBrowseConnect драйвер может возвращать ключевые слова для запроса пользователя на имя сервера. Когда приложение возвращает имя сервера, драйвер может возвращать ключевые слова для запроса пользователя к базе данных. Процесс просмотра будет завершен после того, как приложение вернуло имя базы данных.
Каждый раз, когда SQLBrowseConnect возвращает новую строку подключения с результатом обзора, она возвращает SQL_NEED_DATA как возвращаемый код. Это сообщает приложению, что процесс подключения не завершен. Пока SQLBrowseConnect не возвращает SQL_SUCCESS, подключение находится в состоянии "Необходимые данные" и не может использоваться в других целях, например для задания атрибута подключения. Приложение может завершить процесс просмотра подключений, вызвав SQLDisconnect.
Этот раздел содержит следующую тему.