Partage via

ConfigTranslator, fonction

  • Article

Conformité
Version introduite : ODBC 2.0

Résumé
ConfigTranslator retourne une option de traduction par défaut pour un traducteur. Il peut s’agir de la DLL translator ou d’une DLL d’installation distincte.

Syntaxe

  
BOOL ConfigTranslator(  
     HWND     hwndParent,  
     DWORD *  pvOption);

Arguments

hwndParent
[Entrée] Poignée de fenêtre parente. La fonction n’affiche aucune boîte de dialogue si le handle est null.

pvOption
[Sortie] Option de traduction 32 bits.

Retours

La fonction retourne TRUE si elle réussit, FALSE en cas d’échec.

Diagnostics

Lorsque ConfigTranslator retourne FALSE, une valeur *pfErrorCode associée est publiée dans la mémoire tampon d’erreur du programme d’installation par un appel à SQLPostInstallerError et peut être obtenue en appelant SQLInstallerError. Le tableau suivant répertorie les valeurs *pfErrorCode qui peuvent être retournées par SQLInstallerError et explique chacune d’elles dans le contexte de cette fonction.

*pfErrorCode Error Description
ODBC_ERROR_INVALID_HWND Handle de fenêtre non valide L’argument hwndParent n’était pas valide ou null.
ODBC_ERROR_DRIVER_SPECIFIC Erreur spécifique au pilote ou au traducteur Erreur spécifique au pilote pour laquelle aucune erreur du programme d’installation ODBC n’est définie. L’argument SzError dans un appel à la fonction SQLPostInstallerError doit contenir le message d’erreur spécifique au pilote.
ODBC_ERROR_INVALID_OPTION Option de traduction non valide L’argument pvOption contenait une valeur non valide.

Commentaires

Si le traducteur ne prend en charge qu’une seule option de traduction, ConfigTranslator retourne TRUE et définit pvOption sur l’option 32 bits. Sinon, il détermine l’option de traduction par défaut à utiliser. ConfigTranslator peut afficher une boîte de dialogue avec laquelle un utilisateur sélectionne une option de traduction par défaut.

Pour obtenir des informations sur Consultez
Obtention d’une option de traduction SQLGetConnectAttr
Sélection d’un traducteur SQLGetTranslator
Définition d’une option de traduction SQLSetConnectAttr