PENUMDIRTREE_CALLBACKW Rückruffunktion (dbghelp.h)
Eine anwendungsdefinierte Rückruffunktion, die mit der funktion EnumDirTree verwendet wird. Sie wird jedes Mal aufgerufen, wenn eine Übereinstimmung gefunden wird.
Die Typen PENUMDIRTREE_CALLBACK und PENUMDIRTREE_CALLBACKW definieren einen Zeiger auf diese Rückruffunktion. EnumDirTreeProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
PENUMDIRTREE_CALLBACKW PenumdirtreeCallbackw;
BOOL PenumdirtreeCallbackw(
[in] PCWSTR FilePath,
[in, optional] PVOID CallerData
)
{...}
Parameter
[in] FilePath
Ein Zeiger auf einen Puffer, der den vollständigen Pfad der gefundenen Datei empfängt.
[in, optional] CallerData
Ein benutzerdefinierter Wert, der in EnumDirTreeoder NULL-angegeben ist. In der Regel wird dieser Parameter von einer Anwendung verwendet, um einen Zeiger an eine Datenstruktur zu übergeben, mit der die Rückruffunktion einen Kontext herstellen kann.
Rückgabewert
Um die Aufzählung fortzusetzen, muss die Rückruffunktion FALSE-zurückgeben.
Um die Aufzählung zu beenden, muss die Rückruffunktion TRUE-zurückgeben.
Bemerkungen
Anmerkung
Der dbghelp.h-Header definiert PENUMDIRTREE_CALLBACK als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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 |
| redistributable | DbgHelp.dll 6.0 oder höher |