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

Voir aussi

Fonctions ImageHlp

ImageUnload

LOADED_IMAGE