IDebugSymbols3::AddSyntheticModuleWide-Methode (dbgeng.h)

Artikel
02/23/2024

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

Syntax

HRESULT AddSyntheticModuleWide(
  [in] ULONG64 Base,
  [in] ULONG   Size,
  [in] PCWSTR  ImagePath,
  [in] PCWSTR  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 Bytes 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. Der vollständige Pfad sollte angegeben werden, sofern bekannt.

[in] ModuleName

Gibt den Modulnamen für das synthetische Modul an.

[in] Flags

Legen Sie auf DEBUG_ADDSYNTHMOD_DEFAULT fest.

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 .

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 neu geladen werden , z. B. durch Aufrufen von Reload , wobei der Module-Parameter auf eine leere Zeichenfolge festgelegt ist, werden alle synthetischen Module verworfen.

Weitere Informationen zu synthetischen Modulen finden Sie unter Synthetische Module.