SQLWriteDSNToIni-Funktion

Konformität
Eingeführte Version: ODBC 1.0

Zusammenfassung
SQLWriteDSNToIni fügt den Systeminformationen eine Datenquelle hinzu.

Syntax

  
BOOL SQLWriteDSNToIni(  
     LPCSTR   lpszDSN,  
     LPCSTR   lpszDriver);  

Argumente

lpszDSN
[Eingabe] Name der hinzuzufügenden Datenquelle.

lpszDriver
[Eingabe] Treiberbeschreibung (in der Regel der Name des zugeordneten DBMS), der Benutzern anstelle des physischen Treibernamens angezeigt wird.

Gibt zurück

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist, FALSE, wenn sie fehlschlägt.

Diagnose

Wenn SQLWriteDSNToIni 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_INVALID_DSN	Ungültiger DSN	Das lpszDSN-Argument enthielt eine Zeichenfolge, die für einen DSN ungültig war.
ODBC_ERROR_INVALID_NAME	Ungültiger Treiber- oder Übersetzername	Das lpszDriver-Argument war ungültig.
ODBC_ERROR_REQUEST_FAILED	Fehler bei der Anforderung	Das Installationsprogramm konnte keinen DSN in der Registrierung erstellen.
ODBC_ERROR_OUT_OF_MEM	Nicht genügend Arbeitsspeicher.	Das Installationsprogramm konnte die Funktion aufgrund eines Mangels an Arbeitsspeicher nicht ausführen.

Kommentare

SQLWriteDSNToIni fügt die Datenquelle dem Abschnitt [ODBC-Datenquellen] der Systeminformationen hinzu. Anschließend wird ein Spezifikationsabschnitt für die Datenquelle erstellt und ein einzelnes Schlüsselwort (Driver) mit dem Namen der Treiber-DLL als Wert hinzugefügt. Wenn der Abschnitt zur Datenquellenspezifikation bereits vorhanden ist, entfernt SQLWriteDSNToIni vor dem Erstellen des neuen Abschnitts den alten Abschnitt.

Der Aufrufer dieser Funktion muss dem Datenquellenspezifikationsabschnitt der Systeminformationen treiberspezifische Schlüsselwörter und Werte hinzufügen.

Wenn der Name der Datenquelle Standard ist, erstellt SQLWriteDSNToIni auch den Standardtreiberspezifikationsabschnitt in den Systeminformationen.

Diese Funktion sollte nur von einer Setup-DLL aufgerufen werden.

Verwandte Funktionen

Informationen über	Finden Sie unter
Hinzufügen, Ändern oder Entfernen einer Datenquelle	ConfigDSN(in der Setup-DLL)
Hinzufügen, Ändern oder Entfernen einer Datenquelle	SQLConfigDataSource
Entfernen eines Datenquellennamens aus den Systeminformationen	SQLRemoveDSNFromIni