Partager via

Fonction SymEnumSymbolsEx (dbghelp.h)

  • Article

Énumère tous les symboles d’un processus.

Syntaxe

BOOL IMAGEAPI SymEnumSymbolsEx(
  [in]           HANDLE                         hProcess,
  [in]           ULONG64                        BaseOfDll,
  [in, optional] PCSTR                          Mask,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
  [in, optional] PVOID                          UserContext,
  [in]           DWORD                          Options
);

Paramètres

[in] hProcess

Handle d’un processus. Ce handle doit avoir été précédemment passé à la fonction SymInitialize .

[in] BaseOfDll

Adresse de base du module. Si cette valeur est égale à zéro et que Mask contient un point d’exclamation ( !), la fonction examine les modules. Si cette valeur est égale à zéro et que Mask ne contient pas de point d’exclamation, la fonction utilise l’étendue établie par la fonction SymSetContext .

[in, optional] Mask

Chaîne générique qui indique les noms des symboles à énumérer. Le texte peut éventuellement contenir les caractères génériques, « * » et « ? ».

Pour spécifier un module ou un ensemble de modules spécifique, commencez le texte par une chaîne générique spécifiant le module, suivie d’un point d’exclamation. Lors de la spécification d’un module, BaseOfDll est ignoré.

Valeur Signification
Foo
 Si BaseOfDll n’est pas égal à zéro, SymEnumSymbols recherche un symbole global nommé « foo ».

Si BaseOfDll est égal à zéro, SymEnumSymbols recherche un symbole local nommé « foo » dans l’étendue établie par l’appel le plus récent à la fonction SymSetContext .
Foo?
 Si BaseOfDll n’est pas égal à zéro, SymEnumSymbols recherche un symbole global qui commence par « foo » et contient ensuite un caractère supplémentaire, tel que « fou » et « pied ».

Si BaseOfDll est égal à zéro, SymEnumSymbols recherche un symbole qui commence par « foo » et contient ensuite un caractère supplémentaire, tel que « fou » et « pied ». La recherche se trouverait dans l’étendue établie par l’appel le plus récent à la fonction SymSetContext .
foo* !bar

SymEnumSymbols recherche dans chaque module chargé qui commence par le texte « foo » un symbole appelé « bar ». Il peut trouver des correspondances telles que celles-ci, « foot !bar », « footlocker !bar » et « fool !bar ».
*!*

SymEnumSymbols énumère chaque symbole dans chaque module chargé.

[in] EnumSymbolsCallback

Fonction de rappel SymEnumSymbolsProc qui reçoit les informations de symbole.

[in, optional] UserContext

Valeur définie par l’utilisateur qui est passée à la fonction de rappel, 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 le contexte pour la fonction de rappel.

[in] Options

Indique les options possibles.

Valeur Signification
SYMENUM_OPTIONS_DEFAULT
1
 Utilisez les options par défaut.
SYMENUM_OPTIONS_INLINE
2
 Énumérer les symboles inline.

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.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête dbghelp.h
Bibliothèque DbgHelp.lib
DLL DbgHelp.dll
Composant redistribuable DbgHelp.dll 6.2 ou version ultérieure