PSYM_ENUMMODULES_CALLBACK fonction de rappel (dbghelp.h)
Fonction de rappel définie par l’application utilisée avec la fonction SymEnumerateModules64 . Il est appelé une fois pour chaque module énuméré et reçoit les informations du module.
Les types PSYM_ENUMMODULES_CALLBACK64 et PSYM_ENUMMODULES_CALLBACKW64 définissent un pointeur vers cette fonction de rappel. SymEnumerateModulesProc64 est un espace réservé pour le nom de fonction défini par l’application.
Syntaxe
PSYM_ENUMMODULES_CALLBACK PsymEnummodulesCallback;
BOOL PsymEnummodulesCallback(
[in] PCSTR ModuleName,
[in] ULONG BaseOfDll,
[in, optional] PVOID UserContext
)
{...}
Paramètres
[in] ModuleName
Nom du module.
[in] BaseOfDll
Adresse de base où le module est chargé en mémoire.
[in, optional] UserContext
Valeur définie par l’utilisateur spécifiée dans SymEnumerateModules64 ou NULL. En règle générale, ce paramètre est utilisé par une application pour passer un pointeur vers une structure de données qui permet à la fonction de rappel d’établir un type de contexte.
Valeur retournée
Si la valeur de retour est TRUE, l’énumération continue.
Si la valeur de retour est FALSE, l’énumération s’arrête.
Remarques
L’application appelante est appelée une seule fois par module jusqu’à ce que tous les modules soient énumérés ou jusqu’à ce que la fonction de rappel d’énumération retourne FALSE.
Cette fonction de rappel remplace la fonction de rappel PSYM_ENUMMODULES_CALLBACK . PSYM_ENUMMODULES_CALLBACK est défini comme suit dans DbgHelp.h.
#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYM_ENUMMODULES_CALLBACK PSYM_ENUMMODULES_CALLBACK64
#else
typedef BOOL
(CALLBACK *PSYM_ENUMMODULES_CALLBACK)(
__in PCSTR ModuleName,
__in ULONG BaseOfDll,
__in_opt PVOID UserContext
);
#endif
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | dbghelp.h |
| Composant redistribuable | DbgHelp.dll 5.1 ou version ultérieure |