Función MapAndLoad (imagehlp.h)
Asigna una imagen y carga previamente los datos del archivo asignado.
Sintaxis
BOOL IMAGEAPI MapAndLoad(
[in] PCSTR ImageName,
[in] PCSTR DllPath,
[out] PLOADED_IMAGE LoadedImage,
[in] BOOL DotDll,
[in] BOOL ReadOnly
);
Parámetros
[in] ImageName
Nombre de archivo de la imagen (archivo ejecutable o DLL) que se carga.
[in] DllPath
Ruta de acceso utilizada para buscar la imagen si no se encuentra el nombre proporcionado. Si este parámetro es NULL, se aplican las reglas de ruta de acceso de búsqueda establecidas mediante la función SearchPath .
[out] LoadedImage
Puntero a una estructura LOADED_IMAGE que recibe información sobre la imagen después de cargarla.
[in] DotDll
Extensión predeterminada que se va a usar si el nombre de la imagen no contiene una extensión de nombre de archivo. Si el valor es TRUE, se usa una extensión .DLL. Si el valor es FALSE, se usa una extensión .EXE.
[in] ReadOnly
Modo de acceso. Si este valor es TRUE, el archivo se asigna solo para acceso de lectura. Si el valor es FALSE, el archivo se asigna para acceso de lectura y escritura.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es TRUE.
Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.
Comentarios
La función MapAndLoad asigna una imagen y carga previamente los datos del archivo asignado. La función correspondiente , UnMapAndLoad, debe usarse para desasignar todos los recursos asignados por la función MapAndLoad .
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
| 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 |