EnumDirTreeW-Funktion (dbghelp.h)
Listet alle Vorkommen der angegebenen Datei in der angegebenen Verzeichnisstruktur auf.
Syntax
BOOL IMAGEAPI EnumDirTreeW(
[in, optional] HANDLE hProcess,
[in] PCWSTR RootPath,
[in] PCWSTR InputPathName,
[out, optional] PWSTR OutputPathBuffer,
[in, optional] PENUMDIRTREE_CALLBACKW cb,
[in, optional] PVOID data
);
Parameter
[in, optional] hProcess
Ein Handle für einen Prozess. Dieser 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 datei, die gefunden werden soll. Sie können einen partiellen Pfad 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-werden.
[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 GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.
Bemerkungen
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 TRUEzurückgibt, bricht EnumDirTree die Suche ab.
Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. Daher führen Aufrufe von mehr als einem Thread zu dieser Funktion wahrscheinlich zu unerwartetem Verhalten oder Speicherbeschädigung. Um dies zu vermeiden, müssen Sie alle gleichzeitigen Aufrufe von mehr als einem Thread mit dieser Funktion synchronisieren.
Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.
Anmerkung
Der dbghelp.h-Header definiert EnumDirTree als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | dbghelp.h |
| Library | Dbghelp.lib |
| DLL- | Dbghelp.dll |
| redistributable | DbgHelp.dll 6.0 oder höher |