Freigeben über


PENUMLOADED_MODULES_CALLBACK Rückruffunktion (dbghelp.h)

Eine anwendungsdefinierte Rückruffunktion, die mit der Funktion EnumerateLoadedModules64 verwendet wird.

Die PENUMLOADED_MODULES_CALLBACK64 - und PENUMLOADED_MODULES_CALLBACKW64-Typen definieren einen Zeiger auf diese Rückruffunktion. EnumerateLoadedModulesProc64 ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PENUMLOADED_MODULES_CALLBACK PenumloadedModulesCallback;

BOOL PenumloadedModulesCallback(
  [in]           PCSTR ModuleName,
  [in]           ULONG ModuleBase,
  [in]           ULONG ModuleSize,
  [in, optional] PVOID UserContext
)
{...}

Parameter

[in] ModuleName

Der Name des aufgezählten Moduls.

[in] ModuleBase

Die Basisadresse des Moduls. Beachten Sie, dass diese Adresse möglicherweise ungültig wird (z. B. kann das Modul entladen werden). Verwenden Sie die Ausnahmebehandlung, wenn Sie auf die Adresse zugreifen oder die Adresse an eine andere Funktion übergeben, um eine Zugriffsverletzung zu verhindern.

[in] ModuleSize

Die Größe des Moduls in Bytes.

[in, optional] UserContext

Optionale benutzerdefinierte Daten. Dieser Wert wird von EnumerateLoadedModules64 übergeben.

Rückgabewert

Um die Enumeration fortzusetzen, muss die Rückruffunktion TRUE zurückgeben.

Zum Beenden der Enumeration muss die Rückruffunktion FALSE zurückgeben.

Hinweise

Diese Rückruffunktion ersetzt die PENUMLOADED_MODULES_CALLBACK Rückruffunktion. PENUMLOADED_MODULES_CALLBACK wird in DbgHelp.h wie folgt definiert.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PENUMLOADED_MODULES_CALLBACK PENUMLOADED_MODULES_CALLBACK64
#else
typedef BOOL (CALLBACK *PENUMLOADED_MODULES_CALLBACK)(
    __in PCSTR ModuleName,
    __in ULONG ModuleBase,
    __in ULONG ModuleSize,
    __in_opt PVOID UserContext
    );
#endif

Anforderungen

   
Zielplattform Windows
Kopfzeile dbghelp.h
Verteilbare Komponente DbgHelp.dll 5.1 oder höher

Weitere Informationen

DbgHelp-Funktionen

EnumerateLoadedModules64