UpdateDebugInfoFile, fonction (imagehlp.h)

Article
02/29/2024

Utilise les informations 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.

Cette fonction a été remplacée par la fonction UpdateDebugInfoFileEx . Utilisez UpdateDebugInfoFileEx pour vérifier la valeur de la somme de contrôle.

Syntaxe

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

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.

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.

Remarques

La fonction UpdateDebugInfoFile 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

UpdateDebugInfoFileEx

Partager via