PSYM_ENUMMODULES_CALLBACK 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_CALLBACK PsymEnummodulesCallback;

BOOL PsymEnummodulesCallback(
  [in]           PCSTR ModuleName,
  [in]           ULONG 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

Weitere Informationen

DbgHelp-Funktionen

SymEnumerateModules64