IDebugEventCallbacksWide::LoadModule-Methode (dbgeng.h)

Artikel
02/06/2025

Die LoadModule- Rückrufmethode wird vom Modul aufgerufen, wenn ein Modulladedebugging-Ereignis im Ziel 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 Bilddatei des Moduls an. Wenn diese Informationen nicht verfügbar sind, wird ImageFileHandle-NULL-.

[in] BaseOffset

Gibt die Basisadresse des Moduls im Speicheradressbereich des Ziels an. Wenn diese Informationen nicht verfügbar sind, wird BaseOffset-NULL-.

[in] ModuleSize

Gibt die Bildgröße des Moduls in Bytes an. Wenn diese Informationen nicht verfügbar sind, wird ModuleSize-NULL-.

[in, optional] ModuleName

Gibt den vereinfachten Modulnamen an, der vom Debuggermodul verwendet wird. In den meisten Fällen entspricht dies dem Namen der Bilddatei, mit Ausnahme der Erweiterung. Wenn diese Informationen nicht verfügbar sind, wird ModuleName-NULL-.

[in, optional] ImageName

Gibt den Namen der Bilddatei des Moduls an, der den Pfad enthalten kann. Wenn diese Informationen nicht verfügbar sind, wird ImageName-NULL-.

[in] CheckSum

Gibt die Prüfsumme der Bilddatei des Moduls an. Wenn diese Informationen nicht verfügbar sind, wird CheckSum-NULL-.

[in] TimeDateStamp

Gibt den Zeit- und Datumsstempel der Bilddatei 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 das Modul dieses Ereignis verarbeitet hat. Ausführliche Informationen zur Behandlung dieses Werts finden Sie unter Monitoring Events.

Bemerkungen

Diese Methode wird nur vom Modul aufgerufen, wenn das DEBUG_EVENT_LOAD_MODULE Flag in der Maske festgelegt wird, die von IDebugEventCallbacksWide::GetInterestMaskzurückgegeben wird.

Nach dem Aufrufen dieser Methode ruft das Modul IDebugEventCallbacksWide::ChangeSymbolStateauf, wobei der parameter Flags enthält, der die Bitkennzeichnung DEBUG_CSS_LOADS enthält.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Monitoring Events.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Freigeben über