BindImageEx, fonction (imagehlp.h)

Article
08/24/2023

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

Syntaxe

BOOL IMAGEAPI BindImageEx(
  [in] DWORD                    Flags,
  [in] PCSTR                    ImageName,
  [in] PCSTR                    DllPath,
  [in] PCSTR                    SymbolPath,
  [in] PIMAGEHLP_STATUS_ROUTINE StatusRoutine
);

Paramètres

[in] Flags

Options de liaison. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur	Signification
BIND_ALL_IMAGES 0x00000004	Lier toutes les images de l’arborescence des appels pour ce fichier.
BIND_CACHE_IMPORT_DLLS 0x00000008	N’ignorez pas les informations de DLL dans le cache entre les appels. Cela améliore les performances lors de la liaison d’un grand nombre d’images.
BIND_NO_BOUND_IMPORTS 0x00000001	Ne générez pas de nouvelle table d’adresses d’importation.
BIND_NO_UPDATE 0x00000002	N’apportez pas de modifications au fichier.

[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 à la recherche du fichier de symboles correspondant.

[in] StatusRoutine

Pointeur vers une routine status. La routine status est appelée pendant la progression de la liaison d’image. Pour plus d’informations, consultez StatusRoutine.

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

Le processus de liaison d’une image consiste à calculer l’adresse virtuelle de chaque fonction importée. L’adresse virtuelle calculée est ensuite enregistrée dans la table d’adresses d’importation (IAT) de l’image d’importation. Par conséquent, l’image est chargée beaucoup plus rapidement, en particulier si elle utilise de nombreuses DLL, car le chargeur système n’a pas à calculer l’adresse de chaque fonction importée.

Si un fichier de symboles correspondant peut être localisé, son horodatage et sa somme de contrôle sont mis à jour.

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

StatusRoutine

Partager via