SearchTreeForFileW, fonction (dbghelp.h)
Recherche une arborescence de répertoires pour un fichier spécifié.
Syntaxe
BOOL IMAGEAPI SearchTreeForFileW(
[in] PCWSTR RootPath,
[in] PCWSTR InputPathName,
[out] PWSTR OutputPathBuffer
);
Paramètres
[in] RootPath
Chemin d’accès où la fonction doit commencer à rechercher le fichier.
[in] InputPathName
Fichier pour lequel la fonction effectuera une recherche. Vous pouvez utiliser un chemin d’accès partiel.
[out] OutputPathBuffer
Pointeur vers une mémoire tampon qui reçoit le chemin d’accès complet au fichier trouvé. Cette chaîne n’est pas modifiée si la valeur de retour est FALSE.
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
La fonction recherche le fichier spécifié par le paramètre InputPathName commençant par le chemin d’accès spécifié dans le paramètre RootPath. La profondeur maximale du chemin d’accès autorisée dans le RootPath est de 32 répertoires. Lorsque la fonction recherche le fichier dans l’arborescence du répertoire, il 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 la 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, 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 SearchTreeForFile 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 5.1 ou version ultérieure |