Fonction SymEnumSourceFiles (dbghelp.h)

  • Article

Énumère tous les fichiers sources d’un processus.

Syntaxe

BOOL IMAGEAPI SymEnumSourceFiles(
  [in]           HANDLE                        hProcess,
  [in]           ULONG64                       ModBase,
  [in, optional] PCSTR                         Mask,
  [in]           PSYM_ENUMSOURCEFILES_CALLBACK cbSrcFiles,
  [in, optional] PVOID                         UserContext
);

Paramètres

[in] hProcess

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

[in] ModBase

Adresse de base du module. Si cette valeur est égale à zéro et que Mask contient un point d’exclamation ( !), la fonction examine plusieurs 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

Expression générique qui indique les noms des fichiers sources à énumérer. Pour spécifier un nom de module, utilisez ! syntaxe mod .

Si ce paramètre a la valeur NULL, la fonction énumère tous les fichiers.

[in] cbSrcFiles

Pointeur vers une fonction de rappel SymEnumSourceFilesProc qui reçoit les informations du fichier source.

[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 un contexte pour la fonction de rappel.

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.

Remarques

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.

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

Voir aussi

Fonctions DbgHelp

SymEnumSourceFilesProc