Teilen über


SQLManageDataSources

Konformität
Eingeführte Version: 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

hwnd
[Eingabe] Handle des übergeordneten Fensters.

Gibt zurück

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

Diagnose

Wenn SQLManageDataSources FALSE zurückgibt, kann ein zugeordneter *pfErrorCode-Wert abgerufen werden, indem SQLInstallerError aufgerufen wird. 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.

*pfErrorCode Fehler BESCHREIBUNG
ODBC_ERROR_GENERAL_ERR Allgemeiner Installationsfehler Es ist ein Fehler aufgetreten, für den kein spezifischer Installationsfehler aufgetreten ist.
ODBC_ERROR_REQUEST_FAILED Fehler bei der Anforderung Fehler beim Aufruf von ConfigDSN .
ODBC_ERROR_INVALID__HWND Ungültiges Fensterhandle Das Argument hwnd war ungültig oder NULL.
ODBC_ERROR_OUT_OF_MEM Nicht genügend Arbeitsspeicher. Das Installationsprogramm konnte die Funktion aufgrund eines Mangels an Arbeitsspeicher nicht ausführen.

Verwalten von Datenquellen

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

ODBC-Datenquellenadministrator (Dialogfeld)

Im Dialogfeld werden die in den Systeminformationen aufgeführten 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 Konfigurierenklickt, ruft SQLManageDataSourcesconfigDSN in der Setup-DLL mit der Option ODBC_CONFIG_DSN auf.

Wenn der Benutzer auf Hinzufügen klickt, zeigt SQLManageDataSources das Dialogfeld Neue Datenquelle erstellen an, wie in der folgenden Abbildung dargestellt.

Dialogfeld

Im Dialogfeld wird eine Liste der installierten Treiber angezeigt. Wenn der Benutzer auf einen Treiber doppelklicken oder einen Treiber auswählt und auf OKklickt, ruft SQLManageDataSourcesConfigDSN in der Setup-DLL auf und übergibt die Option ODBC_ADD_DSN.

Wenn der Benutzer eine Datenquelle auswählt und auf Entfernen klickt, fragt SQLManageDataSources , ob der Benutzer die Datenquelle löschen möchte. Wenn der Benutzer auf Ja klickt, ruft SQLManageDataSourcesconfigDSN in der Setup-DLL mit der Option ODBC_REMOVE_DSN auf.

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 in den Systeminformationen wie folgt 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 löschen oder die Konfiguration für eine Systemdatenquelle festlegen.

Eine Datenquelle, die mit einem Systemdatenquellennamen (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 eintrag HKEY_CURRENT_USER registriert. Es ist nicht an einen Benutzer gebunden, der sich mit seinem bestimmten Benutzernamen und Kennwort anmeldet, sondern kann von jedem Benutzer dieses Computers oder von einem automatischen systemweiten Dienst verwendet werden. Der System-DSN ist jedoch an einen Computer gebunden. Die Verwendung von Remote-DSNs zwischen Computern wird nicht unterstützt. System-DSNs werden in den Systeminformationen wie folgt registriert:

HKEY_LOCAL_MACHINE SOFTWARE ODBC-Odbc.ini

Datei-DSNs

Eine Dateidatenquelle verfügt nicht über einen Datenquellennamen, ebenso wie eine Computerdatenquelle, und sie 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 freigegeben 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 freigegeben werden. In diesem Fall kann sie nur auf einem einzelnen Computer verwendet werden.

Weitere Informationen zu Dateidatenquellen finden Sie unter Herstellen einer Verbindung mithilfe von Dateidatenquellen oder unter SQLDriverConnect.

Verwalten von Treibern

Wenn der Benutzer im Dialogfeld ODBC-Datenquellenadministrator auf die Registerkarte Treiber klickt, zeigt SQLManageDataSources eine Liste der auf dem 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 im Dialogfeld ODBC-Datenquellenadministrator auf die Registerkarte Ablaufverfolgungklickt, zeigt SQLManageDataSources Ablaufverfolgungsoptionen an, wie in der folgenden Abbildung dargestellt.

Registerkarte

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

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

Wichtig

Die Unterstützung für Visual Studio Analyzer wurde ab Windows 8 entfernt (Visual Studio Analyzer war nur in älteren Versionen von Visual Studio enthalten.) Verwenden Sie für einen alternativen Problembehandlungsmechanismus die BID-Ablaufverfolgung.

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

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

Informationen über Finden Sie unter
Erstellen von Datenquellen SQLCreateDataSource