MapAndLoad, fonction (imagehlp.h)
Mappe une image et précharge les données du fichier mappé.
Syntaxe
BOOL IMAGEAPI MapAndLoad(
[in] PCSTR ImageName,
[in] PCSTR DllPath,
[out] PLOADED_IMAGE LoadedImage,
[in] BOOL DotDll,
[in] BOOL ReadOnly
);
Paramètres
[in] ImageName
Nom de fichier de l’image (fichier exécutable ou DLL) chargée.
[in] DllPath
Chemin d’accès utilisé pour localiser l’image si le nom fourni est introuvable. Si ce paramètre a la valeur NULL, les règles de chemin de recherche définies à l’aide de la fonction SearchPath s’appliquent.
[out] LoadedImage
Pointeur vers une structure LOADED_IMAGE qui reçoit des informations sur l’image après son chargement.
[in] DotDll
Extension par défaut à utiliser si le nom de l’image ne contient pas d’extension de nom de fichier. Si la valeur est TRUE, une extension .DLL est utilisée. Si la valeur est FALSE, une extension .EXE est utilisée.
[in] ReadOnly
Mode d’accès. Si cette valeur est TRUE, le fichier est mappé pour l’accès en lecture seule. Si la valeur est FALSE, le fichier est mappé pour l’accès en lecture et en écriture.
Valeur retournée
Si la fonction réussit, la valeur de retour est TRUE.
Si la fonction échoue, la valeur de retour est FALSE. Pour récupérer des informations d’erreur étendues, appelez GetLastError.
Notes
La fonction MapAndLoad mappe une image et précharge les données du fichier mappé. La fonction correspondante, UnMapAndLoad, doit être utilisée pour libérer toutes les ressources allouées par la fonction MapAndLoad .
Toutes les fonctions ImageHlp, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imagehlp.h |
| Bibliothèque | Imagehlp.lib |
| DLL | Imagehlp.dll |