Contagem de uso

Nota

A partir do Windows XP e do Windows Server 2003, o ODBC está incluído no sistema operacional 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 de uso de arquivos opcionais. A contagem de uso de componentes ajuda a DLL do instalador a manter as entradas do Registro. É armazenada no valor UsageCount nas subchaves ODBC Core, driver e tradutor. Para obter o formato do valor UsageCount e obter 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 do valor UsageCount nessa subchave como 1. Quando o componente é instalado novamente, a DLL do instalador aumenta a contagem de uso. Quando o componente é removido, a DLL do instalador diminui a contagem de uso. Se a contagem de uso se tornar 0, a DLL do instalador removerá a subchave do componente.

Atenção

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 do arquivo chegam a zero.

As contagens de uso de arquivos ajudam a determinar quando um arquivo deve realmente ser copiado ou excluído, em vez de aumentar ou diminuir a contagem de uso. Isso é importante, pois os componentes ODBC e, portanto, os arquivos nos componentes ODBC, são compartilhados e podem ser instalados ou removidos por vários aplicativos. O aplicativo poderá excluir arquivos de driver e tradutor se a contagem de uso do componente e a contagem de uso do arquivo chegarem a zero. No entanto, os arquivos do Gerenciador de Driver não devem ser excluídos quando a contagem de uso de componentes e a contagem de uso de arquivos se tornam zero, pois esses arquivos podem ser usados por outros aplicativos que não aumentaram a contagem de uso de arquivos.

Nota

As contagens de uso de arquivos são opcionais no Microsoft WindowsNT/Windows2000.

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 na seguinte chave para cada arquivo desse componente que ainda não está no sistema:

Nota

HKEY_LOCAL_MACHINE

SOFTWARE

Microsoft

Windows

CurrentVersion

SharedDlls

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

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

Nome Tipo de dados Dados
full-path REG_DWORD count

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