SymEnumSymbolsExW, fonction (dbghelp.h)

Article
11/20/2024

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

Syntaxe

BOOL IMAGEAPI SymEnumSymbolsExW(
  [in]           HANDLE                          hProcess,
  [in]           ULONG64                         BaseOfDll,
  [in, optional] PCWSTR                          Mask,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACKW EnumSymbolsCallback,
  [in, optional] PVOID                           UserContext,
  [in]           DWORD                           Options
);

Paramètres

[in] hProcess

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

[in] BaseOfDll

Adresse de base du module. Si cette valeur est égale à zéro et Mask contient un point d’exclamation ( !), la fonction examine les modules. Si cette valeur est égale à zéro et 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 spécifique de modules, commencez le texte par une chaîne générique spécifiant le module, suivi d’un point d’exclamation. Lorsque vous spécifiez un module, baseOfDll est ignoré.

Valeur	Signification
foo	Si BaseOfDll n’est pas 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 zéro, alors SymEnumSymbols recherche un symbole global qui commence par « foo » et contient un caractère supplémentaire par la suite, tel que « idiot » et « pied ». Si BaseOfDll est zéro, alors SymEnumSymbols recherche un symbole qui commence par « foo » et contient un caractère supplémentaire par la suite, tel que « idiot » et « pied ». La recherche se trouve 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 » pour un symbole appelé « bar ». Il pourrait 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

Une fonction de rappel SymEnumSymbolsProcW qui reçoit les informations de symbole.

[in, optional] UserContext

Valeur définie par l’utilisateur transmise à 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 un 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 de retour

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

Note

L’en-tête dbghelp.h définit SymEnumSymbolsEx comme 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.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	dbghelp.h
bibliothèque	DbgHelp.lib
DLL	DbgHelp.dll
redistribuable	DbgHelp.dll 6.2 ou version ultérieure

Partager via