Funzione EnumDirTree (dbghelp.h)

  • Articolo

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

Vedi anche

Funzioni DbgHelp

EnumDirTreeProc