Partager via


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

Voir aussi

Fonctions ImageHlp

LOADED_IMAGE

UnMapAndLoad