Partager via


Fonction EnumDirTree (dbghelp.h)

Énumère toutes les occurrences du fichier spécifié dans l’arborescence de répertoires spécifiée.

Syntaxe

BOOL IMAGEAPI EnumDirTree(
  [in, optional]  HANDLE                hProcess,
  [in]            PCSTR                 RootPath,
  [in]            PCSTR                 InputPathName,
  [out, optional] PSTR                  OutputPathBuffer,
  [in, optional]  PENUMDIRTREE_CALLBACK cb,
  [in, optional]  PVOID                 data
);

Paramètres

[in, optional] hProcess

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

[in] RootPath

Chemin d’accès où la fonction doit commencer à rechercher le fichier.

[in] InputPathName

Nom du fichier à trouver. Vous pouvez spécifier un chemin d’accès partiel.

[out, optional] OutputPathBuffer

Pointeur vers une mémoire tampon qui reçoit le chemin d’accès complet du fichier. Si la fonction échoue ou ne trouve pas de fichier correspondant, cette mémoire tampon contient toujours le dernier chemin d’accès complet trouvé.

Ce paramètre est facultatif et peut être NULL.

[in, optional] cb

Fonction de rappel définie par l’application, ou NULL. Pour plus d’informations, consultez EnumDirTreeProc.

[in, optional] data

Données définies par l’utilisateur ou NULL. Cette valeur est passée à 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.

Notes

La recherche peut être annulée si vous inscrivez une fonction de rappel SymRegisterCallbackProc64 . Pour chaque opération de fichier, EnumDirTree appelle cette fonction de rappel avec CBA_DEFERRED_SYMBOL_LOAD_CANCEL. Si la fonction de rappel retourne TRUE, EnumDirTree annule la recherche.

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.0 ou version ultérieure

Voir aussi

Fonctions DbgHelp

EnumDirTreeProc