ConfigTranslator-Funktion

Konformität
Eingeführte Version: ODBC 2.0

Zusammenfassung
ConfigTranslator gibt eine Standardübersetzungsoption für einen Übersetzer zurück. Es kann sich in der Translator-DLL oder in einer separaten Setup-DLL befinden.

Syntax

  
BOOL ConfigTranslator(  
     HWND     hwndParent,  
     DWORD *  pvOption);  

Argumente

hwndParent
[Eingabe] Handle des übergeordneten Fensters. Die Funktion zeigt keine Dialogfelder an, wenn das Handle NULL ist.

pvOption
[Ausgabe] Eine 32-Bit-Übersetzungsoption.

Gibt zurück

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

Diagnose

Wenn ConfigTranslator FALSE zurückgibt, wird ein zugeordneter *pfErrorCode-Wert durch einen Aufruf von SQLPostInstallerError an den Fehlerpuffer des Installationsprogramms gesendet und kann durch Aufrufen von SQLInstallerError 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_HWND	Ungültiges Fensterhandle	Das Argument hwndParent war ungültig oder NULL.
ODBC_ERROR_DRIVER_SPECIFIC	Treiber- oder Übersetzerfehler	Ein treiberspezifischer Fehler, für den kein definierter ODBC-Installerfehler vorliegt. Das SzError-Argument in einem Aufruf der FUNKTION SQLPostInstallerError sollte die treiberspezifische Fehlermeldung enthalten.
ODBC_ERROR_INVALID_OPTION	Ungültige Übersetzungsoption	Das pvOption-Argument enthielt einen ungültigen Wert.

Kommentare

Wenn der Translator nur eine einzelne Übersetzungsoption unterstützt, gibt ConfigTranslator TRUE zurück und legt pvOption auf die 32-Bit-Option fest. Andernfalls wird die zu verwendende Standardübersetzungsoption bestimmt. ConfigTranslator kann ein Dialogfeld anzeigen, mit dem ein Benutzer eine Standardübersetzungsoption auswählt.

Verwandte Funktionen

Informationen über	Finden Sie unter
Abrufen einer Übersetzungsoption	SQLGetConnectAttr
Auswählen eines Übersetzers	SQLGetTranslator
Festlegen einer Übersetzungsoption	SQLSetConnectAttr