Partilhar via

Função ConfigTranslator

  • Artigo

Conformidade
Versão introduzida: ODBC 2.0

Resumo
ConfigTranslator retorna uma opção de tradução padrão para um tradutor. Ele pode estar na DLL do tradutor ou em uma DLL de configuração separada.

Sintaxe

  
BOOL ConfigTranslator(  
     HWND     hwndParent,  
     DWORD *  pvOption);

Argumentos

hwndParent
[Entrada] Identificador de janela pai. A função não exibirá nenhuma caixa de diálogo se o identificador for nulo.

pvOption
[Saída] Uma opção de tradução de 32 bits.

Retornos

A função retornará TRUE se for bem-sucedida, FALSE se falhar.

Diagnósticos

Quando ConfigTranslator retorna FALSE, um valor *pfErrorCode associado é postado no buffer de erros do instalador por uma chamada para SQLPostInstallerError e pode ser obtido chamando SQLInstallerError. A tabela a seguir lista os valores *pfErrorCode que podem ser retornados por SQLInstallerError e explica cada um deles no contexto dessa função.

*pfErrorCode Erro Descrição
ODBC_ERROR_INVALID_HWND Identificador de janela inválido O argumento hwndParent era inválido ou NULL.
ODBC_ERROR_DRIVER_SPECIFIC Erro específico do driver ou do tradutor Um erro específico do driver para o qual não há nenhum erro definido do instalador ODBC. O argumento SzError em uma chamada para a função SQLPostInstallerError deve conter a mensagem de erro específica do driver.
ODBC_ERROR_INVALID_OPTION Opção de tradução inválida O argumento pvOption continha um valor inválido.

Comentários

Se o tradutor der suporte apenas a uma única opção de tradução, ConfigTranslator retornará TRUE e definirá pvOption como a opção de 32 bits. Caso contrário, ele determina a opção de tradução padrão a ser usada. O ConfigTranslator pode exibir uma caixa de diálogo com a qual um usuário seleciona uma opção de tradução padrão.

Para obter informações sobre Consulte
Obtendo uma opção de tradução SQLGetConnectAttr
Selecionando um tradutor SQLGetTranslator
Definindo uma opção de tradução SQLSetConnectAttr