Funzione EnumDirTree (dbghelp.h)
Enumera tutte le occorrenze del file specificato nell'albero della directory specificata.
Sintassi
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
);
Parametri
[in, optional] hProcess
Handle a un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .
[in] RootPath
Percorso in cui la funzione deve iniziare a cercare il file.
[in] InputPathName
Nome del file da trovare. È possibile specificare un percorso parziale.
[out, optional] OutputPathBuffer
Puntatore a un buffer che riceve il percorso completo del file. Se la funzione ha esito negativo o non trova un file corrispondente, questo buffer conterrà comunque l'ultimo percorso completo trovato.
Questo parametro è facoltativo e può essere NULL.
[in, optional] cb
Funzione di callback definita dall'applicazione o NULL. Per altre informazioni, vedere EnumDirTreeProc.
[in, optional] data
Dati definiti dall'utente o NULL. Questo valore viene passato alla funzione di callback.
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 ricerca può essere annullata se si registra una funzione di callback SymRegisterCallbackProc64 . Per ogni operazione di file, EnumDirTree chiama questa funzione di callback con CBA_DEFERRED_SYMBOL_LOAD_CANCEL. Se la funzione callback restituisce TRUE, EnumDirTree annulla la ricerca.
Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione potrebbero causare 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 6.0 o versione successiva |