Share via

Fonction SearchTreeForFile (dbghelp.h)

  • Article

Recherche un fichier spécifié dans une arborescence de répertoires.

Syntaxe

BOOL IMAGEAPI SearchTreeForFile(
  [in]  PCSTR RootPath,
  [in]  PCSTR InputPathName,
  [out] PSTR  OutputPathBuffer
);

Paramètres

[in] RootPath

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

[in] InputPathName

Fichier pour lequel la fonction recherchera. Vous pouvez utiliser un chemin d’accès partiel.

[out] OutputPathBuffer

Pointeur vers une mémoire tampon qui reçoit le chemin complet du fichier trouvé. Cette chaîne n’est pas modifiée si la valeur de retour est FALSE.

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 fonction recherche le fichier spécifié par le paramètre InputPathName en commençant par le chemin spécifié dans le paramètre RootPath . La profondeur de chemin maximale autorisée dans RootPath est de 32 répertoires. Lorsque la fonction trouve le fichier dans l’arborescence de répertoires, elle place le chemin d’accès complet au fichier dans la mémoire tampon spécifiée par le paramètre OutputPathBuffer . Le système de fichiers sous-jacent spécifie l’ordre de recherche dans le sous-répertoire.

La recherche peut être annulée si vous inscrivez une fonction de rappel SymRegisterCallbackProc64 . Pour chaque répertoire recherché, SearchTreeForFile appelle cette fonction de rappel avec CBA_DEFERRED_SYMBOL_LOAD_CANCEL. Si la fonction de rappel retourne TRUE, SearchTreeForFile annule la recherche.

Cette fonction déclenche un événement CBA_DEFERRED_SYMBOL_LOAD_CANCEL par répertoire recherché. Cela permet à l’appelant d’annuler 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 5.1 ou version ultérieure

Voir aussi

Fonctions DbgHelp