Partilhar via

Função SQLRemoveDriverManager

  • Artigo

Conformidade
Versão introduzida: ODBC 3.0: preterido no Windows XP Service Pack 2, Windows Server 2003 Service Pack 1 e sistemas operacionais posteriores.

Resumo
SQLRemoveDriverManager altera ou remove informações sobre os componentes principais do ODBC da entrada Odbcinst.ini nas informações do sistema.

Sintaxe

  
BOOL SQLRemoveDriverManager(  
     LPDWORD     pdwUsageCount);

Argumentos

pdwUsageCount
[Saída] A contagem de uso do Gerenciador de Driver 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 SQLRemoveDriverManager 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 Gerenciador de Driver porque elas não existiam no registro ou não puderam ser encontradas no registro.
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 Gerenciador de 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

SQLRemoveDriverManager complementa a função SQLInstallDriverManager 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.

SQLRemoveDriverManager diminuirá a contagem de uso do componente principal em 1. Se a contagem de uso do componente for para 0, as informações do sistema de entrada serão removidas. A entrada do componente principal está no seguinte local nas informações do sistema, sob o título "ODBC Core":

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

Cuidado

Um aplicativo não deve remover fisicamente os arquivos do Gerenciador de Driver quando a contagem de uso do componente e a contagem de uso de arquivos atingirem zero.

SQLRemoveDriverManager não remove nenhum arquivo. O programa de chamada é responsável por excluir arquivos e manter as contagens de uso de arquivo. No entanto, os arquivos do Gerenciador de Driver não devem ser removidos quando a contagem de uso do componente e a contagem de uso de arquivos atingirem zero, pois esses arquivos podem ser usados por outros aplicativos que não incrementaram a contagem de uso de arquivos.

SQLRemoveDriverManager é chamado como parte do processo de desinstalação. Os componentes principais do ODBC (que incluem o Gerenciador de Driver, a Biblioteca de Cursores, o Instalador, a Biblioteca de Idiomas, o Administrador, os arquivos de conversão e assim por diante) são desinstalados como um todo. Os seguintes arquivos não são removidos quando SQLRemoveDriverManager é chamado como parte do processo de desinstalação:

ODBC32DLL
ODBCCR32.DLL
ODBCCU32.DLL
ODBCINT.DLL
ODBCTRAC.DLL
MSVCRT40.DLL
ODBCCP32.CPL

ODBCCP32.DLL
ODBC16GT.DLL
ODBC32GT.DLL
DS16GT.DLL
DS32GT.DLL
ODBCAD32.EXE

SQLRemoveDriverManager 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.

SQLRemoveDriverManager deve primeiro ser chamado para diminuir a contagem de uso do componente. SQLInstallDriverEx deve ser chamado para incrementar a contagem de uso do componente. O programa de instalação do aplicativo deve substituir os arquivos de componentes principais antigos pelos novos arquivos. As contagens de uso de arquivo permanecerão as mesmas, e outros aplicativos que usam os arquivos de componente principal da versão mais antiga agora usarão os arquivos de versão mais recentes.

Para obter informações sobre Consulte
Instalando um Gerenciador de Driver SQLInstallDriverManager