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 |