Compartilhar via


Verificação de CRC durante uma instalação

Uma CRC (verificação de redundância cíclica) de arquivos está disponível com o Windows Installer. Verificação de CRC é um mecanismo de verificação de erros, semelhante a uma soma de verificação, que permite a um aplicativo determinar se as informações em um arquivo foram modificadas. Depois de o Windows Installer terminar de copiar um arquivo, ele obtém um valor CRC dos arquivos de origem e destino. O instalador verifica a CRC original aplicada no arquivo e compara com a CRC calculada com base na cópia. A verificação de CRC falhará se o valor CRC original não for nulo e for diferente da CRC calculada na cópia. Se a CRC original for nula, nenhuma verificação ocorrerá.

O Windows Installer faz uma verificação de CRC em um arquivo nos seguintes casos:

  • se a propriedade MSICHECKCRCS está definida e msidbFileAttributesChecksum está incluído no campo Attributes do registro do arquivo na tabela File. o instalador faz uma verificação de CRC uma vez depois de instalar, duplicar ou mover o arquivo.
  • se a propriedade MSICHECKCRCS está definida e msidbFileAttributesChecksum está incluído no campo Attributes do registro do arquivo na tabela File, o instalador faz uma verificação de CRC após aplicar um patch no arquivo.
  • se msidbFileAttributesChecksum está incluído no campo Atributos do registro do arquivo na tabela File, o instalador faz uma verificação de CRC antes de associar as imagens.

Se a verificação falhar antes de associar uma imagem, o instalador relatará os dois erros a seguir no arquivo de log e continuará a instalação sem associar o arquivo.

Código Mensagem
2941 Não é possível calcular a CRC do arquivo [2].
2942 A ação BindImage não foi executada no arquivo [2].

 

Se a verificação falhar depois que um arquivo descompactado foi copiado, duplicado ou corrigido, o instalador relatará o erro a seguir. Esse erro também será relatado se a verificação falhar depois que um arquivo compactado for copiado. Se o arquivo tiver o atributo msidbFileAttributesVital, o arquivo será considerado vital para a instalação e o usuário terá a opção de repetir ou cancelar a instalação. Se o arquivo estiver marcado como não vital na coluna Attributes da tabela File, o usuário poderá ignorar o erro e continuar, tentar novamente ou cancelar a instalação.

Código Mensagem
1331 Falhou ao copiar corretamente o arquivo [2]: erro de CRC.

 

Observe que apenas os arquivos descompactados são movidos. Se a verificação falhar depois que um arquivo descompactado for movido, o instalador exibirá o erro a seguir. Se o arquivo tiver o atributo msidbFileAttributesVital, o arquivo será considerado vital para a instalação e a instalação falhará. Se o arquivo estiver marcado como não vital na coluna Attributes da tabela File, o usuário terá a opção de cancelar ou ignorar o erro e continuar a instalação.

Código Mensagem
1332 Falhou ao mover corretamente o arquivo [2]: erro de CRC.

 

Se a verificação falhar depois que um arquivo descompactado for corrigido, o instalador exibirá o erro a seguir. Se o arquivo tiver o atributo msidbFileAttributesVital, o arquivo será considerado vital para a instalação e a instalação falhará. Se o arquivo estiver marcado como não vital na coluna Attributes da tabela File, o usuário terá a opção de cancelar ou ignorar o erro e continuar a instalação.

Código Mensagem
1333 Falhou ao aplicar corretamente o patch no arquivo [2]: erro de CRC.