Función MapAndLoad (imagehlp.h)

  • Artículo

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

Consulte también

Funciones ImageHlp

LOADED_IMAGE

UnMapAndLoad