Función CheckSumMappedFile (imagehlp.h)
Calcula la suma de comprobación del archivo de imagen especificado.
Sintaxis
PIMAGE_NT_HEADERS IMAGEAPI CheckSumMappedFile(
[in] PVOID BaseAddress,
[in] DWORD FileLength,
[out] PDWORD HeaderSum,
[out] PDWORD CheckSum
);
Parámetros
[in] BaseAddress
Dirección base del archivo asignado. Este valor se obtiene llamando a la función MapViewOfFile .
[in] FileLength
Tamaño del archivo, en bytes.
[out] HeaderSum
Puntero a una variable que recibe la suma de comprobación original del archivo de imagen o cero si se produce un error.
[out] CheckSum
Puntero a la variable que recibe la suma de comprobación calculada.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un puntero a la estructura IMAGE_NT_HEADERS contenida en la imagen asignada.
Si la función no se realiza correctamente, el valor devuelto es NULL. Para recuperar información de error extendida, llame a GetLastError.
Comentarios
La función CheckSumMappedFile calcula una nueva suma de comprobación para el archivo y la devuelve en el parámetro CheckSum . Cualquier aplicación que cree o modifique una imagen ejecutable usa esta función. Las sumas de comprobación son necesarias para los controladores en modo kernel y algunos archivos DLL del sistema. El enlazador calcula la suma de comprobación original en el momento del vínculo, si usa el modificador del enlazador adecuado. Para más información, consulte la documentación del vinculador.
Se recomienda que todas las imágenes tengan sumas de comprobación válidas. Es responsabilidad del autor de la llamada colocar la suma de comprobación recién calculada en la imagen asignada y actualizar la imagen en disco del archivo.
Todas las funciones ImageHlp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | imagehlp.h |
| Library | Imagehlp.lib |
| Archivo DLL | Imagehlp.dll |