IDebugSymbols3::AddSyntheticSymbol-Methode (dbgeng.h)

Artikel
02/23/2024

Die AddSyntheticSymbol-Methode fügt einem Modul im aktuellen Prozess ein synthetisches Symbol hinzu.

Syntax

HRESULT AddSyntheticSymbol(
  [in]            ULONG64              Offset,
  [in]            ULONG                Size,
  [in]            PCSTR                Name,
  [in]            ULONG                Flags,
  [out, optional] PDEBUG_MODULE_AND_ID Id
);

Parameter

[in] Offset

Gibt den Speicherort im virtuellen Adressraum des Prozesses des synthetischen Symbols an.

[in] Size

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

[in] Name

Gibt den Namen des synthetischen Symbols an.

[in] Flags

Auf DEBUG_ADDSYNTHSYM_DEFAULT festgelegt.

[out, optional] Id

Empfängt die DEBUG_MODULE_AND_ID Struktur, die das synthetische Symbol identifiziert. Wenn IDNULL ist, werden diese Informationen nicht zurückgegeben.

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

Die Position des synthetischen Symbols darf nicht mit der Position eines anderen Symbols identisch sein.

Wenn das Modul, das ein synthetisches Symbol enthält, neu geladen wird , z. B. durch Aufrufen von Reload , wobei der Parameter Module auf den Namen des Moduls festgelegt ist, wird das synthetische Symbol verworfen.

Weitere Informationen zu synthetischen Symbolen finden Sie unter Synthetische Symbole.