IDebugSymbols3::AddSyntheticModule-Methode (dbgeng.h)

Artikel
02/06/2025

Die AddSyntheticModule--Methode fügt der Modulliste ein synthetisches Modul hinzu, das der Debugger für den aktuellen Prozessverwaltet.

Syntax

HRESULT AddSyntheticModule(
  [in] ULONG64 Base,
  [in] ULONG   Size,
  [in] PCSTR   ImagePath,
  [in] PCSTR   ModuleName,
  [in] ULONG   Flags
);

Parameter

[in] Base

Gibt den Speicherort im virtuellen Adressraum des Prozesses der Basis des synthetischen Moduls an.

[in] Size

Gibt die Größe in Byte des synthetischen Moduls an.

[in] ImagePath

Gibt den Bildnamen des synthetischen Moduls an. Dies ist der Name, der als Name der ausführbaren Datei für das synthetische Modul zurückgegeben wird. Der vollständige Pfad sollte eingeschlossen werden, wenn bekannt.

[in] ModuleName

Gibt den Modulnamen für das synthetische Modul an.

[in] Flags

Auf DEBUG_ADDSYNTHMOD_DEFAULT festgelegt.

Rückgabewert

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Bemerkungen

Der durch die Base und Size Parameter beschriebene Speicherbereich des synthetischen Moduls darf den Speicherbereich eines anderen Moduls nicht überlappen.

Wenn alle Module neu geladen werden , z. B. durch Aufrufen von Reload mit dem Parameter Modul auf eine leere Zeichenfolge festgelegt, werden alle synthetischen Module verworfen.

Weitere Informationen zu synthetischen Modulen finden Sie unter synthetische Module.