Partilhar via


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

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

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

  • Se a propriedade MSICHECKCRCS estiver definida e msidbFileAttributesChecksum será incluída no campo Atributos do registro do arquivo na tabela Arquivo . O instalador faz a verificação CRC uma vez depois de instalar, duplicar ou mover o arquivo.
  • Se a propriedade MSICHECKCRCS estiver definida e msidbFileAttributesChecksum estiver incluído no campo Atributos do registo do ficheiro na tabela Ficheiro , o instalador fará uma verificação CRC após corrigir o ficheiro.
  • Se o msidbFileAttributesChecksum estiver incluído no campo de Atributos do registo do arquivo na tabela de Arquivo , o instalador realiza uma verificação de CRC antes de vincular imagens.

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

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

 

Se a verificação falhar depois que um arquivo não compactado tiver sido copiado, duplicado ou corrigido, o instalador relatará o seguinte erro. Este erro também é relatado se a verificação falhar depois que um arquivo compactado é 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 tentar novamente ou cancelar a instalação. Se o arquivo estiver marcado como não vital na coluna Atributos da tabela Arquivo , o usuário poderá ignorar o erro e continuar, tentar novamente ou cancelar a instalação.

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

 

Observe que apenas os arquivos não compactados são movidos. Se a verificação falhar depois que um arquivo descompactado for movido, o instalador exibirá o seguinte erro. 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 Atributos da tabela Arquivo , o usuário terá a opção de cancelar ou ignorar o erro e continuar a instalação.

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

 

Se a verificação falhar depois que um arquivo descompactado for corrigido, o instalador exibirá o seguinte erro. 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 Atributos da tabela Arquivo , o usuário terá a opção de cancelar ou ignorar o erro e continuar a instalação.

Código Mensagem
1333 Falha ao corrigir corretamente o arquivo [2]: erro CRC.