Funzione SearchTreeForFile (dbghelp.h)
Cerca un file specificato in un albero di directory.
Sintassi
BOOL IMAGEAPI SearchTreeForFile(
[in] PCSTR RootPath,
[in] PCSTR InputPathName,
[out] PSTR OutputPathBuffer
);
Parametri
[in] RootPath
Percorso in cui la funzione deve iniziare a cercare il file.
[in] InputPathName
File in cui verrà eseguita la ricerca della funzione. È possibile usare un percorso parziale.
[out] OutputPathBuffer
Puntatore a un buffer che riceve il percorso completo del file trovato. Questa stringa non viene modificata se il valore restituito è FALSE.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è TRUE.
Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Commenti
La funzione cerca il file specificato dal parametro InputPathName a partire dal percorso specificato nel parametro RootPath . La profondità massima del percorso consentita in RootPath è di 32 directory. Quando la funzione trova il file nell'albero di directory, inserisce il percorso completo del file nel buffer specificato dal parametro OutputPathBuffer . Il file system sottostante specifica l'ordine della ricerca nella sottodirectory.
La ricerca può essere annullata se si registra una funzione di callback SymRegisterCallbackProc64 . Per ogni directory cercata, SearchTreeForFile chiama questa funzione di callback con CBA_DEFERRED_SYMBOL_LOAD_CANCEL. Se la funzione di callback restituisce TRUE, SearchTreeForFile annulla la ricerca.
Questa funzione attiva un evento CBA_DEFERRED_SYMBOL_LOAD_CANCEL per ogni directory cercata. In questo modo il chiamante può annullare la ricerca.
Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.
Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | dbghelp.h |
| Libreria | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Componente ridistribuibile | DbgHelp.dll 5.1 o versione successiva |