Freigeben über

ConfigTranslator-Funktion

  • Artikel

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.

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