SQLManageDataSources

Konformitäts-
Version eingeführt: ODBC 2.0

Zusammenfassung
SQLManageDataSources- zeigt ein Dialogfeld an, mit dem Benutzer Datenquellen in den Systeminformationen einrichten, hinzufügen und löschen können.

Syntax

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

Argumente

[Eingabe] Übergeordnete Fensterziehpunkt.

Ertrag

SQLManageDataSources FALSE zurück, wenn hwnd kein gültiges Fensterhandle ist. Andernfalls wird WAHR zurückgegeben.

Diagnostik

Wenn SQLManageDataSources FALSE zurückgibt, kann ein zugeordneter *pfErrorCode- Wert durch Aufrufen SQLInstallerError-abgerufen werden. In der folgenden Tabelle sind die *pfErrorCode- Werte aufgeführt, die von SQLInstallerError- zurückgegeben werden können, und erläutert die einzelnen Werte im Kontext dieser Funktion.

Verwalten von Datenquellen

SQLManageDataSources- zeigt zunächst das Dialogfeld ODBC-Datenquellenadministrator an, wie in der folgenden Abbildung dargestellt.

Dialogfeld

Im Dialogfeld werden die in den Systeminformationen aufgelisteten Datenquellen auf drei Registerkarten angezeigt: Benutzer-DSN-, System-DSN-und Datei-DSN-. Wenn der Benutzer auf eine Datenquelle doppelklicken oder eine Datenquelle auswählt und auf Configureklickt, SQLManageDataSources aufruft ConfigDSN in der Setup-DLL mit der Option ODBC_CONFIG_DSN.

Wenn der Benutzer auf Hinzufügenklickt, zeigt SQLManageDataSources- das Dialogfeld "Neue Datenquelle erstellen" in der folgenden Abbildung an.

Im Dialogfeld wird eine Liste der installierten Treiber angezeigt. Wenn der Benutzer auf einen Treiber doppelklicken oder einen Treiber auswählt und auf OKklickt, SQLManageDataSources aufruft ConfigDSN in der Setup-DLL und übergibt ihn die option ODBC_ADD_DSN.

Wenn der Benutzer eine Datenquelle auswählt und auf Removeklickt, SQLManageDataSources fragt, ob der Benutzer die Datenquelle löschen möchte. Wenn der Benutzer auf Jaklickt, SQLManageDataSources aufruft ConfigDSN in der Setup-DLL mit der Option ODBC_REMOVE_DSN.

Das Dialogfeld Neue Datenquelle erstellen wird verwendet, um eine Benutzerdatenquelle, eine Systemdatenquelle oder eine Dateidatenquelle hinzuzufügen oder zu löschen.

Benutzer-DSNs

DsNs, die für einzelne Benutzer erstellt wurden, werden als Benutzer-DSNs bezeichnet, um sie von System-DSNs zu unterscheiden. Benutzer-DSNs werden wie folgt in den Systeminformationen registriert:

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

System-DSNs

Im Dialogfeld Neue Datenquelle erstellen können Sie ihrem lokalen Computer eine Systemdatenquelle hinzufügen oder eine Datenquelle löschen oder die Konfiguration für eine Systemdatenquelle festlegen.

Eine Datenquelle, die mit einem Systemdatenquellennamen (DATA Source Name, DSN) eingerichtet ist, kann von mehreren Benutzern auf demselben Computer verwendet werden. Sie kann auch von einem systemweiten Dienst verwendet werden, der dann Zugriff auf die Datenquelle erhält, auch wenn kein Benutzer am Computer angemeldet ist.

Ein System-DSN wird im HKEY_LOCAL_MACHINE Eintrag in den Systeminformationen und nicht im HKEY_CURRENT_USER Eintrag registriert. Es ist nicht an einen Benutzer gebunden, der sich mit dem jeweiligen Benutzernamen und Kennwort anmeldet, kann aber von jedem Benutzer dieses Computers oder von einem automatischen systemweiten Dienst verwendet werden. Das System DSN ist jedoch an einen Computer gebunden. Die Verwendung von Remote-DSNs zwischen Computern wird nicht unterstützt. System-DSNs werden wie folgt in den Systeminformationen registriert:

HKEY_LOCAL_MACHINE SOFTWARE ODBC-Odbc.ini

Datei-DSNs

Eine Dateidatenquelle hat keinen Datenquellennamen, ebenso wie eine Computerdatenquelle, und ist nicht für einen Benutzer oder Computer registriert. Die Verbindungsinformationen für diese Datenquelle sind in einer DSN-Datei enthalten, die auf einen beliebigen Computer kopiert werden kann. Eine Dateidatenquelle kann gemeinsam genutzt werden, in diesem Fall befindet sich die DSN-Datei in einem Netzwerk und kann gleichzeitig von mehreren Benutzern im Netzwerk verwendet werden, solange der Benutzer den entsprechenden Treiber installiert hat. Eine Dateidatenquelle kann auch nicht freigabefähig sein, in diesem Fall kann sie nur auf einem einzelnen Computer verwendet werden.

Weitere Informationen zu Dateidatenquellen finden Sie unter Herstellen einer Verbindung mit Dateidatenquellenoder SQLDriverConnect-.

Verwalten von Treibern

Wenn der Benutzer auf die Registerkarte Treiber im Dialogfeld ODBC-Datenquellenadministrator klickt, zeigt SQLManageDataSources eine Liste der im System installierten ODBC-Treiber sowie Informationen zu den Treibern an. Das angezeigte Datum ist das Erstellungsdatum des Treibers, wie in der folgenden Abbildung dargestellt.

Registerkarte

Ablaufverfolgungsoptionen

Wenn der Benutzer auf die Registerkarte Ablaufverfolgung im Dialogfeld ODBC-Datenquellenadministrator klickt, zeigt SQLManageDataSources Ablaufverfolgungsoptionen an, wie in der folgenden Abbildung dargestellt.

Registerkarte

Wenn der Benutzer auf Jetzt ablaufverfolgung starten klickt und dann auf OKklickt, SQLManageDataSources die Ablaufverfolgung für alle Anwendungen, die derzeit auf dem Computer ausgeführt werden, manuell aktiviert.

Wenn der Benutzer den Namen einer Ablaufverfolgungsdatei im Textfeld Protokolldateipfad angibt und dann auf OKklickt, SQLManageDataSources legt das Schlüsselwort TraceFile Schlüsselwort im Abschnitt [ODBC] der Systeminformationen auf den angegebenen Namen fest.

Wenn der Benutzer auf Visual Studio Analyzer starten klickt und dann auf OKklickt, ist Visual Studio Analyzer aktiviert. Sie bleibt aktiviert, bis Visual Studio Analyzer beenden geklickt wird.

Weitere Informationen zur Ablaufverfolgung finden Sie unter Ablaufverfolgung. Weitere Informationen zum Trace- und TraceFile- Schlüsselwörtern finden Sie unter ODBC-Unterschlüssel-.

Verwandte Funktionen