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

Vedi anche

Funzioni DbgHelp