UpdateDebugInfoFile, fonction (imagehlp.h)
Utilise les informations spécifiées pour mettre à jour les champs correspondants dans le fichier de symboles.
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 |