Fonction MapDebugInformation (dbghelp.h)

Article
02/29/2024

Obtient l’accès aux informations de débogage d’une image.

Note Cette fonction est fournie uniquement pour la compatibilité descendante. Il ne retourne pas d’informations fiables. Les nouvelles applications doivent utiliser les fonctions SymGetModuleInfo64 et SymLoadModule64 .

Syntaxe

PIMAGE_DEBUG_INFORMATION IMAGEAPI MapDebugInformation(
  [in, optional] HANDLE FileHandle,
  [in]           PCSTR  FileName,
  [in, optional] PCSTR  SymbolPath,
  [in]           ULONG  ImageBase
);

Paramètres

[in, optional] FileHandle

Handle vers une image exécutable ouverte ou NULL.

[in] FileName

Nom d’un fichier image exécutable ou NULL.

[in, optional] SymbolPath

Chemin d’accès où se trouvent les fichiers de symboles. Le chemin d’accès peut être plusieurs chemins séparés par des points-virgules. Pour récupérer le chemin du symbole, utilisez la fonction SymGetSearchPath .

[in] ImageBase

Adresse de base de l’image ou zéro.

Valeur retournée

Si la fonction réussit, la valeur de retour est un pointeur vers une structure IMAGE_DEBUG_INFORMATION .

Si la fonction échoue, la valeur de retour est NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Remarques

La fonction MapDebugInformation est utilisée pour obtenir l’accès aux informations de débogage d’une image. Les informations de débogage sont extraites de l’image ou du fichier de symboles et placées dans la structure IMAGE_DEBUG_INFORMATION . Cette structure est allouée par la bibliothèque et doit être libérée à l’aide de la fonction UnmapDebugInformation . La mémoire de la structure n’étant pas dans le tas par défaut du processus, les tentatives de libération avec une routine de transfert de mémoire échouent.

Toutes les fonctions DbgHelp, 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

Condition requise	Valeur
Plateforme cible	Windows
En-tête	dbghelp.h
Bibliothèque	Dbghelp.lib
DLL	Dbghelp.dll
Composant redistribuable	DbgHelp.dll 5.1 ou version ultérieure

Voir aussi

Fonctions DbgHelp

IMAGE_DEBUG_INFORMATION

SymGetSearchPath

UnmapDebugInformation

Partager via