Função SQLRemoveTranslator

Conformidade
Versão introduzida: ODBC 3.0

Resumo
SQLRemoveTranslator remove informações sobre um tradutor da seção Odbcinst.ini das informações do sistema e diminui a contagem de uso de componentes do tradutor em 1.

Sintaxe

  
BOOL SQLRemoveTranslator(  
     LPCSTR    lpszTranslator,  
     LPDWORD   lpdwUsageCount);  

Argumentos

lpszTranslator
[Entrada] O nome do tradutor conforme registrado na chave Odbcinst.ini das informações do sistema.

lpdwUsageCount
[Saída] A contagem de uso do tradutor após essa função ter sido chamada.

Retornos

A função retornará TRUE se for bem-sucedida, FALSE se falhar. Se nenhuma entrada existir nas informações do sistema quando essa função for chamada, a função retornará FALSE.

Diagnósticos

Quando SQLRemoveTranslator retorna FALSE, um valor *pfErrorCode associado 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_GENERAL_ERR	Erro geral do instalador	Ocorreu um erro para o qual não houve nenhum erro específico do instalador.
ODBC_ERROR_COMPONENT_NOT_FOUND	Componente não encontrado no registro	O instalador não pôde remover as informações do tradutor porque elas não existiam no registro ou não puderam ser encontradas no registro.
ODBC_ERROR_INVALID_NAME	Nome do driver ou tradutor inválido	O argumento lpszTranslator era inválido.
ODBC_ERROR_USAGE_UPDATE_FAILED	Não foi possível incrementar ou diminuir a contagem de uso do componente	O instalador não conseguiu diminuir a contagem de uso do driver.
ODBC_ERROR_OUT_OF_MEM	Memória insuficiente	O instalador não pôde executar a função devido à falta de memória.

Comentários

SQLRemoveTranslator complementa a função SQLInstallTranslatorEx e atualiza a contagem de uso do componente nas informações do sistema. Essa função deve ser chamada somente de um aplicativo de instalação.

SQLRemoveTranslator diminuirá a contagem de uso do componente em 1. Se a contagem de uso do componente for para 0, a entrada do tradutor nas informações do sistema será removida. A entrada do tradutor está no seguinte local nas informações do sistema, sob o nome do tradutor:

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

SQLRemoveTranslator não remove nenhum arquivo. O programa de chamada é responsável por excluir arquivos e manter a contagem de uso de arquivos. Somente depois que a contagem de uso do componente e a contagem de uso de arquivos atingirem zero será um arquivo excluído fisicamente. Alguns arquivos em um componente podem ser excluídos e outros não excluídos, dependendo se os arquivos são usados por outros aplicativos que incrementaram a contagem de uso de arquivos.

SQLRemoveTranslator também é chamado como parte de um processo de atualização. Se um aplicativo detectar que precisa executar uma atualização e tiver instalado anteriormente o driver, o driver deverá ser removido e reinstalado. SQLRemoveTranslator deve primeiro ser chamado para diminuir a contagem de uso do componente e, em seguida, SQLInstallTranslatorEx deve ser chamado para incrementar a contagem de uso do componente. O programa de instalação do aplicativo deve substituir fisicamente os arquivos antigos pelos novos arquivos. A contagem de uso de arquivos permanecerá a mesma, e outros aplicativos que usam os arquivos de versão mais antigos agora usarão a versão mais recente.

Funções relacionadas

Para obter informações sobre	Consulte
Instalando um tradutor	SQLInstallTranslatorEx