Función ConfigTranslator

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.

Funciones relacionadas

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