IDebugSymbols3::AddSyntheticModule-Methode (dbgeng.h)

Artikel
02/23/2024

Die AddSyntheticModule-Methode fügt der Modulliste, die der Debugger für den aktuellen Prozess verwaltet, ein synthetisches Modul hinzu.

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 des synthetischen Moduls in Byte an.

[in] ImagePath

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

[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 gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

Der Speicherbereich des synthetischen Moduls, der durch die Parameter Base und Size beschrieben wird, darf den Speicherbereich eines anderen Moduls nicht überlappen.

Wenn alle Module erneut geladen werden , z. B. durch Aufrufen von Reload , wobei der Parameter Module auf eine leere Zeichenfolge festgelegt ist, werden alle synthetischen Module verworfen.

Weitere Informationen zu synthetischen Modulen finden Sie unter Synthetische Module.