IDebugEventCallbacksWide::LoadModule-Methode (dbgeng.h)

Artikel
02/23/2024

Die LoadModule-Rückrufmethode wird von der Engine aufgerufen, wenn im Ziel ein Debugereignis zum Laden des Moduls auftritt.

Syntax

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCWSTR  ModuleName,
  [in, optional] PCWSTR  ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp
);

Parameter

[in] ImageFileHandle

Gibt das Handle für die Imagedatei des Moduls an. Wenn diese Informationen nicht verfügbar sind, ist ImageFileHandleNULL.

[in] BaseOffset

Gibt die Basisadresse des Moduls im Speicheradressraum des Ziels an. Wenn diese Informationen nicht verfügbar sind, ist BaseOffsetNULL.

[in] ModuleSize

Gibt die Bildgröße des Moduls in Bytes an. Wenn diese Informationen nicht verfügbar sind, ist ModuleSizeNULL.

[in, optional] ModuleName

Gibt den vereinfachten Modulnamen an, der von der Debugger-Engine verwendet wird. In den meisten Fällen entspricht dies dem Namen der Imagedatei mit Ausnahme der Erweiterung. Wenn diese Informationen nicht verfügbar sind, lautet ModuleNameNULL.

[in, optional] ImageName

Gibt den Imagedateinamen des Moduls an, der den Pfad enthalten kann. Wenn diese Informationen nicht verfügbar sind, ist ImageNameNULL.

[in] CheckSum

Gibt die Prüfsumme der Imagedatei des Moduls an. Wenn diese Informationen nicht verfügbar sind, ist CheckSumNULL.

[in] TimeDateStamp

Gibt den Zeit- und Datumsstempel der Imagedatei des Moduls an. Wenn diese Informationen nicht verfügbar sind, ist TimeDateStamp 0.

Rückgabewert

Diese Methode gibt einen DEBUG_STATUS_XXX Wert zurück, der angibt, wie die Ausführung des Ziels nach der Verarbeitung dieses Ereignisses durch das Modul fortgesetzt werden soll. Ausführliche Informationen zur Behandlung dieses Werts durch das Modul finden Sie unter Überwachungsereignisse.

Hinweise

Diese Methode wird nur von der Engine aufgerufen, wenn das DEBUG_EVENT_LOAD_MODULE-Flag in der von IDebugEventCallbacksWide::GetInterestMask zurückgegebenen Maske festgelegt ist.

Nach dem Aufrufen dieser Methode ruft die Engine IDebugEventCallbacksWide::ChangeSymbolState auf, wobei der Flags-Parameter das Bitflag DEBUG_CSS_LOADS enthält.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter Überwachen von Ereignissen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (einschließlich Dbgeng.h)

Freigeben über