SQLSetConfigMode-Funktion

Konformität
Eingeführte Version: ODBC 3.0

Zusammenfassung
SQLSetConfigMode legt den Konfigurationsmodus fest, der angibt, wo sich die Odbc.ini Eintragseintrags-DSN-Werte in den Systeminformationen befindet.

Syntax

  
BOOL SQLSetConfigMode(  
     UWORD     wConfigMode);  

Argumente

wConfigMode
[Eingabe] Der Konfigurationsmodus des Installationsprogramms (siehe "Kommentare"). Der Wert in wConfigMode kann wie folgt sein:

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 SQLSetConfigMode FALSE zurückgibt, kann durch Aufrufen von SQLInstallerError ein zugeordneter*pfErrorCode-Wert 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.

*pfErrorCode	Fehler	BESCHREIBUNG
ODBC_ERROR_INVALID_PARAM_SEQUENCE	Ungültige Parametersequenz	Das Argument wConfigMode enthielt keine ODBC_USER_DSN, ODBC_SYSTEM_DSN oder ODBC_BOTH_DSN.

Kommentare

Diese Funktion wird verwendet, um festzulegen, wo sich der Odbc.ini Eintragseintrag mit dsN-Werten in den Systeminformationen befindet. Wenn wConfigMode 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.

Diese Funktion wirkt sich nicht auf SQLCreateDataSource und SQLDriverConnect aus. Der Konfigurationsmodus muss festgelegt werden, wenn ein Treiber durch Aufrufen von SQLGetPrivateProfileString aus der Registrierung liest oder durch Aufrufen von SQLWritePrivateProfileString in die Registrierung schreibt. Aufrufe von SQLGetPrivateProfileString und SQLWritePrivateProfileString verwenden den Konfigurationsmodus, um zu ermitteln, mit welchem Teil der Registrierung ausgeführt werden soll.

Achtung

SQLSetConfigMode sollte nur bei Bedarf aufgerufen werden. Wenn der Modus nicht ordnungsgemäß festgelegt ist, funktioniert der ODBC-Installer möglicherweise nicht ordnungsgemäß.

SQLSetConfigMode nimmt eine direkte Registrierungsänderung des Konfigurationsmodus vor. Dies gilt abgesehen von der Änderung des Konfigurationsmodus durch einen Aufruf von SQLConfigDataSource. Ein Aufruf von SQLConfigDataSource legt den Konfigurationsmodus so fest, dass benutzer- und System-DSNs beim Ändern eines DSN unterschieden werden. Vor der Rückgabe setzt SQLConfigDataSource den Konfigurationsmodus auf BOTHDSN zurück.

Verwandte Funktionen

Informationen über	Finden Sie unter
Erstellen einer Datenquelle	SQLCreateDataSource
Herstellen einer Verbindung mit einer Datenquelle mithilfe einer Verbindungszeichenfolge oder eines Dialogfelds	SQLDriverConnect
Abrufen des Konfigurationsmodus	SQLGetConfigMode