Función ImageLoad (imagehlp.h)
Mantiene una lista de archivos DLL cargados.
Sintaxis
PLOADED_IMAGE IMAGEAPI ImageLoad(
[in] PCSTR DllName,
[in] PCSTR DllPath
);
Parámetros
[in] DllName
Nombre de la imagen.
[in] DllPath
Ruta de acceso utilizada para buscar la imagen si no se encuentra el nombre proporcionado. Si se usa NULL , se aplican las reglas de ruta de acceso de búsqueda establecidas en la función SearchPath .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un puntero a una estructura de LOADED_IMAGE .
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 ImageLoad se usa para mantener una lista de archivos DLL cargados. Si la imagen ya se ha cargado, se devuelve el LOADED_IMAGE anterior. De lo contrario, la nueva imagen se agrega a la lista.
La estructura LOADED_IMAGE debe desasignarse mediante la función ImageUnload .
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 |