EnumDirTree-Funktion (dbghelp.h)

Listet alle Vorkommen der angegebenen Datei in der angegebenen Verzeichnisstruktur auf.

Syntax

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
);

Parameter

[in, optional] hProcess

Ein Handle für einen Prozess. Dieses Handle muss zuvor an die SymInitialize-Funktion übergeben worden sein.

[in] RootPath

Der Pfad, in dem die Funktion mit der Suche nach der Datei beginnen soll.

[in] InputPathName

Der Name der zu findenden Datei. Sie können einen Teilpfad angeben.

[out, optional] OutputPathBuffer

Ein Zeiger auf einen Puffer, der den vollständigen Pfad der Datei empfängt. Wenn die Funktion fehlschlägt oder keine übereinstimmende Datei findet, enthält dieser Puffer weiterhin den letzten vollständigen Pfad, der gefunden wurde.

Dieser Parameter ist optional und kann NULL sein.

[in, optional] cb

Eine anwendungsdefinierte Rückruffunktion oder NULL. Weitere Informationen finden Sie unter EnumDirTreeProc.

[in, optional] data

Die benutzerdefinierten Daten oder NULL. Dieser Wert wird an die Rückruffunktion übergeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Die Suche kann abgebrochen werden, wenn Sie eine SymRegisterCallbackProc64-Rückruffunktion registrieren. Für jeden Dateivorgang ruft EnumDirTree diese Rückruffunktion mit CBA_DEFERRED_SYMBOL_LOAD_CANCEL auf. Wenn die Rückruffunktion TRUE zurückgibt, Bricht EnumDirTree die Suche ab.

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.

Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.

Anforderungen

Zielplattform	Windows
Kopfzeile	dbghelp.h
Bibliothek	Dbghelp.lib
DLL	Dbghelp.dll
Verteilbare Komponente	DbgHelp.dll 6.0 oder höher

Weitere Informationen

DbgHelp-Funktionen

EnumDirTreeProc