PSYM_ENUMERATESYMBOLS_CALLBACKW fonction de rappel (dbghelp.h)

Article
11/20/2024

Fonction de rappel définie par l’application utilisée avec les fonctions SymEnumSymbols, SymEnumTypeset Fonctions SymEnumTypesByName.

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

Syntaxe

PSYM_ENUMERATESYMBOLS_CALLBACKW PsymEnumeratesymbolsCallbackw;

BOOL PsymEnumeratesymbolsCallbackw(
  [in]           PSYMBOL_INFOW pSymInfo,
  [in]           ULONG SymbolSize,
  [in, optional] PVOID UserContext
)
{...}

Paramètres

[in] pSymInfo

Pointeur vers une structure SYMBOL_INFO qui fournit des informations sur le symbole.

[in] SymbolSize

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

[in, optional] UserContext

Valeur définie par l’utilisateur transmise à partir de la fonction SymEnumSymbols ou SymEnumTypes, ou NULL. Ce paramètre est généralement utilisé par une application pour passer un pointeur vers une structure de données qui fournit des informations contextuelles pour la fonction de rappel.

Valeur de retour

Si la fonction retourne TRUE, l’énumération continue.

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

Remarques

Note

L’en-tête dbghelp.h définit PSYM_ENUMERATESYMBOLS_CALLBACK en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.