PSYM_ENUMSYMBOLS_CALLBACK fonction de rappel (dbghelp.h)

Article
08/23/2023

Fonction de rappel définie par l’application utilisée avec la fonction SymEnumerateSymbols64 . Il est appelé une fois pour chaque symbole énuméré et reçoit les informations de symbole.

Les types PSYM_ENUMSYMBOLS_CALLBACK64 et PSYM_ENUMSYMBOLS_CALLBACK64W définissent un pointeur vers cette fonction de rappel. SymEnumerateSymbolsProc64 est un espace réservé pour le nom de la fonction définie par l’application.

Note Cette fonction est fournie uniquement à des fins de compatibilité. Les applications doivent utiliser SymEnumSymbols.

Syntaxe

PSYM_ENUMSYMBOLS_CALLBACK PsymEnumsymbolsCallback;

BOOL PsymEnumsymbolsCallback(
  [in]           PCSTR SymbolName,
  [in]           ULONG SymbolAddress,
  [in]           ULONG SymbolSize,
  [in, optional] PVOID UserContext
)
{...}

Paramètres

[in] SymbolName

Nom du symbole. Le nom peut être supprimé si l’option SYMOPT_UNDNAME est utilisée avec la fonction SymSetOptions .

[in] SymbolAddress

Adresse virtuelle du début du symbole.

[in] SymbolSize

Taille du symbole, en octets. La taille est calculée et est en fait une valeur de meilleure estimation. Dans certains cas, la valeur peut être égale à zéro.

[in, optional] UserContext

Valeur définie par l’utilisateur spécifiée dans SymEnumerateSymbols64 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 fonction retourne TRUE, l’énumération continue.

Si la fonction retourne FALSE, l’énumération s’arrête.

Notes

L’application appelante est appelée une fois par symbole jusqu’à ce que tous les symboles 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_ENUMSYMBOLS_CALLBACK . PSYM_ENUMSYMBOLS_CALLBACK est défini comme suit dans Dbghelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYM_ENUMSYMBOLS_CALLBACK PSYM_ENUMSYMBOLS_CALLBACK64
#define PSYM_ENUMSYMBOLS_CALLBACKW PSYM_ENUMSYMBOLS_CALLBACK64W
#else
typedef BOOL
(CALLBACK *PSYM_ENUMSYMBOLS_CALLBACK)(
    __in PCSTR SymbolName,
    __in ULONG SymbolAddress,
    __in ULONG SymbolSize,
    __in_opt PVOID UserContext
    );

typedef BOOL
(CALLBACK *PSYM_ENUMSYMBOLS_CALLBACKW)(
    __in PCWSTR SymbolName,
    __in ULONG SymbolAddress,
    __in ULONG SymbolSize,
    __in_opt PVOID UserContext
    );
#endif

Spécifications


Plateforme cible	Windows
En-tête	dbghelp.h
Composant redistribuable	DbgHelp.dll 5.1 ou version ultérieure

Voir aussi

Fonctions DbgHelp

SymEnumSymbols

SymEnumerateSymbols64

Partager via