Compartir a través de

Función ConfigTranslator

  • Artículo

Conformidad
Versión introducida: ODBC 2.0

Resumen
ConfigTranslator devuelve una opción de traducción predeterminada para un traductor. Puede estar en el archivo DLL del traductor o en un archivo DLL de configuración independiente.

Sintaxis

  
BOOL ConfigTranslator(  
     HWND     hwndParent,  
     DWORD *  pvOption);

Argumentos

hwndParent
[Entrada] Identificador de ventana principal. La función no mostrará ningún cuadro de diálogo si el identificador es null.

pvOption
[Salida] Una opción de traducción de 32 bits.

Devoluciones

La función devuelve TRUE si se ejecuta correctamente, FALSE si se produce un error.

Diagnóstico

Cuando ConfigTranslator devuelve FALSE, un valor *pfErrorCode asociado se publica en el búfer de errores del instalador mediante una llamada a SQLPostInstallerError y se puede obtener llamando a SQLInstallerError. En la tabla siguiente se enumeran los valores *pfErrorCode que SQLInstallerError puede devolver y explica cada uno en el contexto de esta función.

*pfErrorCode Error Descripción
ODBC_ERROR_INVALID_HWND Identificador de ventana no válido El argumento hwndParent no era válido o NULL.
ODBC_ERROR_DRIVER_SPECIFIC Error específico del controlador o del traductor Error específico del controlador para el que no hay ningún error de instalador ODBC definido. El argumento SzError de una llamada a la función SQLPostInstallerError debe contener el mensaje de error específico del controlador.
ODBC_ERROR_INVALID_OPTION Opción de traducción no válida El argumento pvOption contenía un valor no válido.

Comentarios

Si el traductor solo admite una sola opción de traducción, ConfigTranslator devuelve TRUE y establece pvOption en la opción de 32 bits. De lo contrario, determina la opción de traducción predeterminada que se va a usar. ConfigTranslator puede mostrar un cuadro de diálogo con el que un usuario selecciona una opción de traducción predeterminada.

Para información acerca de Vea
Obtención de una opción de traducción SQLGetConnectAttr
Selección de un traductor SQLGetTranslator
Establecer una opción de traducción SQLSetConnectAttr