Condividi tramite

Funzione ConfigTranslator

  • Articolo

Conformità
Versione introdotta: ODBC 2.0

Riepilogo
ConfigTranslator restituisce un'opzione di traduzione predefinita per un traduttore. Può trovarsi nella DLL del traduttore o in una DLL di installazione separata.

Sintassi

  
BOOL ConfigTranslator(  
     HWND     hwndParent,  
     DWORD *  pvOption);

Argomenti

hwndParent
[Input] Handle della finestra padre. La funzione non visualizzerà finestre di dialogo se l'handle è Null.

pvOption
[Output] Opzione di conversione a 32 bit.

Resi

Se ha esito positivo, la funzione restituisce TRUE se ha esito negativo.

Diagnostica

Quando ConfigTranslator restituisce FALSE, un valore *pfErrorCode associato viene inviato al buffer degli errori del programma di installazione tramite una chiamata a SQLPostInstallerError e può essere ottenuto chiamando SQLInstallerError. Nella tabella seguente sono elencati i valori *pfErrorCode che possono essere restituiti da SQLInstallerError e spiega ognuno nel contesto di questa funzione.

*pfErrorCode Errore Descrizione
ODBC_ERROR_INVALID_HWND Handle di finestra non valido L'argomento hwndParent non è valido o NULL.
ODBC_ERROR_DRIVER_SPECIFIC Errore specifico del driver o del traduttore Errore specifico del driver per il quale non è presente alcun errore di programma di installazione ODBC definito. L'argomento SzError in una chiamata alla funzione SQLPostInstallerError deve contenere il messaggio di errore specifico del driver.
ODBC_ERROR_INVALID_OPTION Opzione di traduzione non valida L'argomento pvOption contiene un valore non valido.

Commenti

Se il traduttore supporta solo una singola opzione di traduzione, ConfigTranslator restituisce TRUE e imposta pvOption sull'opzione a 32 bit. In caso contrario, determina l'opzione di conversione predefinita da usare. ConfigTranslator può visualizzare una finestra di dialogo con cui un utente seleziona un'opzione di conversione predefinita.

Per informazioni su Vedere
Ottenere un'opzione di traduzione SQLGetConnectAttr
Selezione di un traduttore SQLGetTranslator
Impostazione di un'opzione di traduzione SQLSetConnectAttr