UpdateDebugInfoFileEx, fonction (imagehlp.h)

Article
02/27/2024

Utilise les informations étendues spécifiées pour mettre à jour les champs correspondants dans le fichier de symboles.

Note Cette fonction fonctionne avec les fichiers .dbg, et non avec les fichiers .pdb.

Syntaxe

BOOL IMAGEAPI UpdateDebugInfoFileEx(
  [in]  PCSTR               ImageFileName,
  [in]  PCSTR               SymbolPath,
  [out] PSTR                DebugFilePath,
  [in]  PIMAGE_NT_HEADERS32 NtHeaders,
  [in]  DWORD               OldCheckSum
);

Paramètres

[in] ImageFileName

Nom de l’image qui est maintenant obsolète par rapport à son fichier de symboles.

[in] SymbolPath

Chemin d’accès dans lequel rechercher le fichier de symboles.

[out] DebugFilePath

Pointeur vers une mémoire tampon qui reçoit le nom du fichier de symboles mis à jour.

[in] NtHeaders

Pointeur vers une structure de IMAGE_NT_HEADERS qui spécifie les nouvelles informations d’en-tête.

[in] OldCheckSum

Valeur de somme de contrôle d’origine. Si cette valeur ne correspond pas à la somme de contrôle présente dans l’image mappée, les indicateurs dans le fichier de symboles contiennent IMAGE_SEPARATE_DEBUG_MISMATCH et la dernière valeur d’erreur est définie sur ERROR_INVALID_DATA.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE.

Remarques

La fonction UpdateDebugInfoFileEx prend les informations stockées dans la structure IMAGE_NT_HEADERS et met à jour les champs correspondants dans le fichier de symboles. Chaque fois qu’un fichier image est modifié, cette fonction doit être appelée pour maintenir la synchronisation des nombres. Plus précisément, chaque fois qu’une somme de contrôle d’image change, le fichier de symboles doit être mis à jour pour correspondre.

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

Condition requise	Valeur
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

IMAGE_NT_HEADERS

Fonctions ImageHlp

Partager via