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

Consulte también

IMAGE_NT_HEADERS

Funciones ImageHlp

MapFileAndCheckSum

MapViewOfFile