Contagem de uso

Observação

A partir do Windows XP e do Windows Server 2003, o ODBC está incluído no sistema de operações do Windows. Você só deve instalar explicitamente o ODBC em versões anteriores do Windows.

Dois tipos de contagens de uso são mantidos no registro para cada componente: uma contagem de uso de componentes e uma ou mais contagens opcionais de uso de arquivo. A contagem de uso do componente ajuda a DLL do instalador a manter as entradas do Registro. Ele é armazenado no valor UsageCount nas subchaves ODBC Core, driver e tradutor. Para obter o formato do valor UsageCount e mais informações sobre essas subchaves, consulte Entradas do Registro para Componentes ODBC.

Quando um componente é instalado pela primeira vez, a DLL do instalador cria uma subchave para ele e define os dados para o valor UsageCount nessa subchave como 1. Quando o componente é instalado novamente, a DLL do instalador incrementa a contagem de uso. Quando o componente é removido, a DLL do instalador diminui a contagem de uso. Se a contagem de uso cair para 0, a DLL do instalador removerá a subchave do componente.

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 atingir zero.

As contagens de uso de arquivo ajudam a determinar quando um arquivo deve realmente ser copiado ou excluído em vez de incrementar ou diminuir a contagem de uso. Isso é importante porque os componentes ODBC e, portanto, os arquivos em componentes ODBC, são compartilhados e podem ser instalados ou removidos por uma variedade de aplicativos. O aplicativo poderá excluir arquivos de driver e tradutor se a contagem de uso do componente e a contagem de uso de arquivos atingirem zero. Os arquivos do Gerenciador de Driver não devem, no entanto, ser excluídos 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.

Observação

As contagens de uso de arquivos são opcionais no Microsoft Windows NT/Windows 2000.

As contagens de uso de arquivos são mantidas pelo programa de instalação depois que ele chama SQLInstallDriverManager, SQLInstallDriverEx, SQLInstallTranslatorEx, SQLRemoveDriverManager, SQLRemoveDriver ou SQLRemoveTranslator.

Quando um componente é instalado pela primeira vez, o programa de instalação ou a DLL do instalador cria um valor sob a seguinte chave para cada arquivo nesse componente que ainda não está no sistema:

Observação

HKEY_LOCAL_MACHINE

SOFTWARE

Microsoft

Windows

CurrentVersion

SharedDlls

Ele define os dados desses valores como 1 e copia o arquivo para o sistema. Quando o componente é instalado novamente, o programa de instalação ou a DLL do instalador incrementa as contagens de uso. Quando o componente é removido, o programa de instalação ou a DLL do instalador diminui as contagens de uso. Se qualquer contagem de uso cair para 0, o programa de instalação ou a DLL do instalador removerá o valor do arquivo e, se o componente for um driver ou um tradutor, excluirá o arquivo. Os arquivos do Gerenciador de Driver não devem ser excluídos.

O formato do valor de contagem de uso de arquivo é mostrado na tabela a seguir.

Nome	Tipo de dados	Dados
caminho completo	REG_DWORD	contagem

Por exemplo, suponha que um driver para Informix use os arquivos Infrmx32.dll e Infrmx32.hlp e suponha que esse driver tenha sido instalado duas vezes. Os valores na subchave SharedDlls para o driver Informix seriam os seguintes:

C:\WINDOWS\SYSTEM32\INFRMX32.DLL : REG_DWORD : 0x2  
C:\WINDOWS\SYSTEM32\INFRMX32.HLP : REG_DWORD : 0x2