Fonction SymSearch (dbghelp.h)

Article
08/23/2023

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

Syntaxe

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

Valeur unique pour le 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 ! syntaxe mod .

[in, optional] Address

Adresse du symbole.

[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

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	À usage interne uniquement.
SYMSEARCH_RECURSE 0x02	Récursez à partir du haut pour rechercher tous les symboles.

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.

Notes

Toutes les fonctions DbgHelp, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération 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.

Spécifications


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

Voir aussi

Fonctions DbgHelp

SymEnumSymbolsProc

Share via