Freigeben über


SQLGetConfigMode-Funktion

Konformität
Eingeführte Version: ODBC 3.0

Zusammenfassung
SQLGetConfigMode ruft den Konfigurationsmodus ab, der angibt, wo sich der Odbc.ini Eintrag mit dsn-Werten in den Systeminformationen befindet.

Syntax

  
BOOL SQLGetConfigMode(  
     UWORD *   pwConfigMode);  

Argumente

pwConfigMode
[Ausgabe] Zeiger auf den Puffer, der den Konfigurationsmodus enthält. (Siehe "Kommentare".) Der Wert in *pwConfigMode kann wie folgt lauten:

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

Gibt zurück

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

Diagnose

Wenn SQLGetConfigMode 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_OUT_OF_MEM Nicht genügend Arbeitsspeicher. Das Installationsprogramm konnte die Funktion aufgrund eines Mangels an Arbeitsspeicher nicht ausführen.

Kommentare

Diese Funktion wird verwendet, um zu bestimmen, wo sich die Odbc.ini Eintragseintrags mit DSN-Werten in den Systeminformationen befindet. Wenn *pwConfigMode ODBC_USER_DSN ist, ist der DSN ein Benutzer-DSN, und die Funktion liest aus dem Odbc.ini Eintrag in HKEY_CURRENT_USER. Wenn es ODBC_SYSTEM_DSN ist, ist der DSN ein System-DSN, und die Funktion liest aus dem Odbc.ini Eintrag in HKEY_LOCAL_MACHINE. Wenn es ODBC_BOTH_DSN ist, wird HKEY_CURRENT_USER versucht, und wenn er fehlschlägt, wird HKEY_LOCAL_MACHINE verwendet.

Standardmäßig gibt SQLGetConfigMode ODBC_BOTH_DSN zurück. Wenn ein Benutzer-DSN oder ein System-DSN durch einen Aufruf von SQLConfigDataSource erstellt wird, legt die Funktion den Konfigurationsmodus auf ODBC_USER_DSN oder ODBC_SYSTEM_DSN fest, um Benutzer- und System-DSNs zu unterscheiden, während ein DSN geändert wird. Vor der Rückgabe setzt SQLConfigDataSource den Konfigurationsmodus auf ODBC_BOTH_DSN zurück.

Informationen über Finden Sie unter
Festlegen des Konfigurationsmodus SQLSetConfigMode