Freigeben über

SQLWriteDSNToIni-Funktion

  • Artikel

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.

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