IDebugSymbols3::AddSyntheticSymbolWide-Methode (dbgeng.h)

Artikel
02/06/2025

Die AddSyntheticSymbolWide Methode fügt einem Modul im aktuellen Prozessein synthetisches Symbol hinzu.

Syntax

HRESULT AddSyntheticSymbolWide(
  [in]            ULONG64              Offset,
  [in]            ULONG                Size,
  [in]            PCWSTR               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 in Byte des synthetischen Symbols 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 ID-NULL-ist, werden diese Informationen nicht zurückgegeben.

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

Die Position des synthetischen Symbols darf nicht mit der Position eines anderen Symbols übereinstimmen.

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

Weitere Informationen zu synthetischen Symbolen finden Sie unter synthetische Symbole.