Função MsiGetFileHashA (msi.h)

A função MsiGetFileHash usa o caminho para um arquivo e retorna um hash de 128 bits desse arquivo. As ferramentas de criação podem usar MsiGetFileHash para obter o hash de arquivo necessário para preencher a tabela MsiFileHash.

O Windows Installer usa o hash de arquivo como um meio de detectar e eliminar a cópia desnecessária de arquivos. Um hash de arquivo armazenado na tabela MsiFileHash pode ser comparado a um hash de um arquivo existente no computador do usuário.

Sintaxe

UINT MsiGetFileHashA(
  [in]  LPCSTR           szFilePath,
  [in]  DWORD            dwOptions,
  [out] PMSIFILEHASHINFO pHash
);

Parâmetros

[in] szFilePath

Caminho para o arquivo que deve ser hash.

[in] dwOptions

O valor nesta coluna deve ser 0. Esse parâmetro é reservado para uso futuro.

[out] pHash

Ponteiro para as informações de hash de arquivo retornadas.

Valor retornado

Comentários

Todo o hash de arquivo de 128 bits é retornado como quatro campos de 32 bits. A numeração dos quatro campos é baseada em zero. Os valores retornados por MsiGetFileHash correspondem aos quatro campos da estrutura MSIFILEHASHINFO . O primeiro campo corresponde à coluna HashPart1 da tabela MsiFileHash, o segundo campo corresponde à coluna HashPart2, o terceiro campo corresponde à coluna HashPart3 e o quarto campo corresponde à coluna HashPart4.

As informações de hash inseridas na tabela MsiFileHash devem ser obtidas chamando MsiGetFileHash ou o método FileHash . Não tente usar outros métodos para gerar o hash do arquivo.

Requisitos

Confira também

Controle de versão de arquivo padrão

MSIFILEHASHINFO

Tabela MsiFileHash