Função CheckSumMappedFile (imagehlp.h)

Calcula a soma de verificação do arquivo de imagem especificado.

Sintaxe

PIMAGE_NT_HEADERS IMAGEAPI CheckSumMappedFile(
  [in]  PVOID  BaseAddress,
  [in]  DWORD  FileLength,
  [out] PDWORD HeaderSum,
  [out] PDWORD CheckSum
);

Parâmetros

[in] BaseAddress

O endereço base do arquivo mapeado. Esse valor é obtido chamando a função MapViewOfFile .

[in] FileLength

O tamanho do arquivo, em bytes.

[out] HeaderSum

Um ponteiro para uma variável que recebe a soma de verificação original do arquivo de imagem ou zero se houver um erro.

[out] CheckSum

Um ponteiro para a variável que recebe a soma de verificação computada.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro para a estrutura IMAGE_NT_HEADERS contida na imagem mapeada.

Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

A função CheckSumMappedFile calcula uma nova soma de verificação para o arquivo e a retorna no parâmetro CheckSum . Essa função é usada por qualquer aplicativo que cria ou modifica uma imagem executável. Somas de verificação são necessárias para drivers no modo kernel e algumas DLLs do sistema. O vinculador computa a soma de verificação original no momento do link, se você usar a opção de vinculador apropriada. Para obter mais detalhes, consulte a documentação do vinculador.

É recomendável que todas as imagens tenham somas de verificação válidas. É responsabilidade do chamador colocar a soma de verificação recém-computada na imagem mapeada e atualizar a imagem em disco do arquivo.

Todas as funções ImageHlp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	imagehlp.h
Biblioteca	Imagehlp.lib
DLL	Imagehlp.dll

Confira também

IMAGE_NT_HEADERS

Funções ImageHlp

MapFileAndCheckSum

Mapviewoffile