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 |