PSYM_ENUMMODULES_CALLBACKW64 Rückruffunktion (dbghelp.h)
Eine anwendungsdefinierte Rückruffunktion, die mit der SymEnumerateModules64-Funktion verwendet wird. Es wird für jedes aufgezählte Modul einmal aufgerufen und empfängt die Modulinformationen.
Die typen PSYM_ENUMMODULES_CALLBACK64 und PSYM_ENUMMODULES_CALLBACKW64 definieren einen Zeiger auf diese Rückruffunktion. SymEnumerateModulesProc64 ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
PSYM_ENUMMODULES_CALLBACKW64 PsymEnummodulesCallbackw64;
BOOL PsymEnummodulesCallbackw64(
[in] PCWSTR ModuleName,
[in] DWORD64 BaseOfDll,
[in, optional] PVOID UserContext
)
{...}
Parameter
[in] ModuleName
Der Name des Moduls.
[in] BaseOfDll
Die Basisadresse, an der das Modul in den Arbeitsspeicher geladen wird.
[in, optional] UserContext
Der benutzerdefinierte Wert, der in SymEnumerateModules64 oder 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 Typ von Kontext einrichten kann.
Rückgabewert
Wenn der Rückgabewert TRUE ist, wird die Enumeration fortgesetzt.
Wenn der Rückgabewert FALSE ist, wird die Enumeration beendet.
Hinweise
Die aufrufende Anwendung wird einmal pro Modul aufgerufen, bis alle Module aufgelistet sind oder bis die Enumerationsrückruffunktion FALSE zurückgibt.
Diese Rückruffunktion ersetzt die PSYM_ENUMMODULES_CALLBACK Rückruffunktion. PSYM_ENUMMODULES_CALLBACK wird in DbgHelp.h wie folgt definiert.
#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYM_ENUMMODULES_CALLBACK PSYM_ENUMMODULES_CALLBACK64
#else
typedef BOOL
(CALLBACK *PSYM_ENUMMODULES_CALLBACK)(
__in PCSTR ModuleName,
__in ULONG BaseOfDll,
__in_opt PVOID UserContext
);
#endif
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | dbghelp.h |
| Verteilbare Komponente | DbgHelp.dll 5.1 oder höher |