SymSearchW, fonction (dbghelp.h)

Article
11/20/2024

Recherche les symboles PDB qui répondent aux critères spécifiés.

Syntaxe

BOOL IMAGEAPI SymSearchW(
  [in]           HANDLE                          hProcess,
  [in]           ULONG64                         BaseOfDll,
  [in, optional] DWORD                           Index,
  [in, optional] DWORD                           SymTag,
  [in, optional] PCWSTR                          Mask,
  [in, optional] DWORD64                         Address,
  [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] Index

Valeur unique du symbole.

[in, optional] SymTag

Classification PDB. Ces valeurs sont définies dans Dbghelp.h dans le type d’énumération SymTagEnum . Pour obtenir des descriptions, consultez la documentation PDB.

[in, optional] Mask

Expression générique qui indique les noms des symboles à énumérer. Pour spécifier un nom de module, utilisez le ! syntaxemod.

[in, optional] Address

Adresse du symbole.

[in] EnumSymbolsCallback

Une fonction de rappel SymEnumSymbolsProc 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

Options qui contrôlent le comportement de cette fonction.

Valeur	Signification
SYMSEARCH_ALLITEMS 0x08	Incluez tous les symboles et autres données dans les fichiers .pdb. DbgHelp 6.6 et versions antérieures : Cette valeur n’est pas prise en charge.
SYMSEARCH_GLOBALSONLY 0x04	Recherchez uniquement les symboles globaux.
SYMSEARCH_MASKOBJS 0x01	Pour une utilisation interne uniquement.
SYMSEARCH_RECURSE 0x02	Récursez à partir du haut pour rechercher tous les symboles.

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

Toutes les fonctions DbgHelp, comme celle-ci, sont monothread. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement une altération inattendue du comportement ou de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.

Pour appeler la version Unicode de cette fonction, définissez DBGHELP_TRANSLATE_TCHAR.

Note

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

Voir aussi

fonctions DbgHelp

SymEnumSymbolsProc

Partager via