Fonction BindImage (imagehlp.h)

Calcule l’adresse virtuelle de chaque fonction importée.

Cette fonction a été remplacée par la fonction BindImageEx . Utilisez BindImageEx pour fournir une status routine ou des indicateurs pour contrôler la liaison d’image.

Syntaxe

BOOL IMAGEAPI BindImage(
  [in] PCSTR ImageName,
  [in] PCSTR DllPath,
  [in] PCSTR SymbolPath
);

Paramètres

[in] ImageName

Nom du fichier à lier. Cette valeur peut être un nom de fichier, un chemin d’accès partiel ou un chemin d’accès complet.

[in] DllPath

Racine du chemin de recherche à utiliser si le fichier spécifié par le paramètre ImageName ne peut pas être ouvert.

[in] SymbolPath

Racine du chemin d’accès pour rechercher le fichier de symboles correspondant du fichier.

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

Un appel à BindImage équivaut à l’appel suivant : BindImageEx( 0, ImageName, DllPath, SymbolPath, NULL );

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

BindImageEx

Fonctions ImageHlp