IDebugEventCallbacks::LoadModule-Methode (dbgeng.h)

Artikel
02/23/2024

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

Syntax

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCSTR   ModuleName,
  [in, optional] PCSTR   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 Byte 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 stimmt dies mit dem Namen der Bilddatei ab, wobei die Erweiterung nicht enthalten ist. Wenn diese Informationen nicht verfügbar sind, ist 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 die Uhrzeit und den Datumsstempel der Imagedatei des Moduls an. Wenn diese Informationen nicht verfügbar sind, ist TimeDateStamp null.

Rückgabewert

Diese Methode gibt einen DEBUG_STATUS_XXX Wert zurück, der angibt, wie die Ausführung des Ziels fortgesetzt werden soll, nachdem die Engine dieses Ereignis verarbeitet hat. Ausführliche Informationen dazu, wie die Engine diesen Wert behandelt, finden Sie unter Überwachen von Ereignissen.

Hinweise

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

Nach dem Aufrufen dieser Methode ruft die Engine IDebugEventCallbacks::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 (dbgeng.h einschließen)

Freigeben über