SQLManageDataSources

соответствие
Представлена версия: ODBC 2.0

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

Синтаксис

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

Аргументы

навесить
[Входные данные] Родительский дескриптор окна.

Возвращает

SQLManageDataSources возвращает значение FALSE, если не является допустимым дескриптором окна. В противном случае возвращает значение TRUE.

Диагностика

При SQLManageDataSources возвращает значение FALSE, связанное *pfErrorCode можно получить путем вызова SQLInstallerError. В следующей таблице перечислены значения *pfErrorCode, которые можно возвращать SQLInstallerError и объясняет каждый из них в контексте этой функции.

Управление источниками данных

SQLManageDataSources изначально отображает диалоговое окно администратора источника данных ODBC, как показано на следующем рисунке.

Диалоговое окно "Администратор источника данных ODBC"

В диалоговом окне отображаются источники данных, перечисленные в системных сведениях на трех вкладках: пользователя DSN, системные dsNи файловых доменных имен. Если пользователь дважды щелкает источник данных или выбирает источник данных и выбирает Настроить, SQLManageDataSources вызывает ConfigDSN в библиотеке DLL установки с параметром ODBC_CONFIG_DSN.

Если пользователь щелкает добавить, SQLManageDataSources отобразит диалоговое окно Создание нового источника данных, показанное на следующем рисунке.

В диалоговом окне отображается список установленных драйверов. Если пользователь дважды щелкает драйвер или выбирает драйвер и щелкает ОК, SQLManageDataSources вызывает ConfigDSN в библиотеке DLL установки и передает его параметру ODBC_ADD_DSN.

Если пользователь выбирает источник данных и щелкает Удалить, SQLManageDataSources спрашивает, хочет ли пользователь удалить источник данных. Если пользователь щелкает да, SQLManageDataSources вызывает ConfigDSN в библиотеке DLL установки с параметром ODBC_REMOVE_DSN.

Диалоговое окно Создание нового источника данных используется для добавления или удаления пользовательского источника данных, системного источника данных или источника данных файла.

Доменные домены пользователей

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

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

Системные доменные сети

Диалоговое окно "Создание нового источника данных" позволяет добавить системный источник данных на локальный компьютер или удалить его или настроить конфигурацию для системного источника данных.

Источник данных, настроенный с именем источника данных системы (DSN), может использоваться несколькими пользователями на одном компьютере. Она также может использоваться системой, которая может получить доступ к источнику данных, даже если пользователь не вошел на компьютер.

Имя dsN системы регистрируется в записи HKEY_LOCAL_MACHINE в системной информации, а не в записи HKEY_CURRENT_USER. Он не связан с одним пользователем, который входит в систему с определенным именем пользователя и паролем, но может использоваться любым пользователем этого компьютера или автоматической системной службой. Система DSN, однако, привязана к одному компьютеру. Она не поддерживает возможность использования удаленных доменных имен между компьютерами. Системные доменные сети регистрируются следующим образом в системной информации:

HKEY_LOCAL_MACHINE SOFTWARE ODBC Odbc.ini

Доменные имена файлов

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

Дополнительные сведения о источниках данных файлов см. в разделе Подключении с помощьюисточников данных файлов или SQLDriverConnect.

Управление драйверами

Если пользователь щелкает вкладку "Драйверы " в диалоговом окне администратора источника данных ODBC, SQLManageDataSources отображает список драйверов ODBC, установленных в системе, а также сведения о драйверах. Отображаемая дата — дата создания драйвера, как показано на следующем рисунке.

Вкладка "Драйверы для администратора источника данных ODBC"

Параметры трассировки

Если пользователь щелкает вкладку трассировки в диалоговом окне администратор источника данных ODBC, SQLManageDataSources отображает параметры трассировки, как показано на следующем рисунке.

вкладка трассировки источника данных ODBC

Если пользователь щелкает начать трассировку, а затем нажимает кнопку ОК, SQLManageDataSources включает трассировку вручную для всех приложений, работающих на компьютере.

Если пользователь задает имя файла трассировки в текстовом поле пути к файлу журнала , а затем щелкает ОК, SQLManageDataSources задает ключевое слово TraceFile в разделе [ODBC] сведений о системе указанным именем.

Если пользователь щелкает запустить анализатор Visual Studio, а затем нажимает кнопку ОК, анализатор Visual Studio включен. Он остается включенным, пока не будет остановить анализатор Visual Studio.

Дополнительные сведения о трассировке см. в трассировки. Дополнительные сведения о ключевых словах трассировки и Trace File см. в подразделе ODBC.

Связанные функции