Fonction ImageLoad (imagehlp.h)
Gère une liste de DLL chargées.
Syntaxe
PLOADED_IMAGE IMAGEAPI ImageLoad(
[in] PCSTR DllName,
[in] PCSTR DllPath
);
Paramètres
[in] DllName
Nom de l'image.
[in] DllPath
Chemin d’accès utilisé pour localiser l’image si le nom fourni est introuvable. Si null est utilisé, les règles de chemin de recherche définies dans la fonction SearchPath s’appliquent.
Valeur retournée
Si la fonction réussit, la valeur de retour est un pointeur vers une structure LOADED_IMAGE .
Si la fonction échoue, la valeur de retour est NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.
Notes
La fonction ImageLoad est utilisée pour gérer une liste de DLL chargées. Si l’image a déjà été chargée, la LOADED_IMAGE précédente est retournée. Sinon, la nouvelle image est ajoutée à la liste.
La structure LOADED_IMAGE doit être libérée par la fonction ImageUnload .
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 |