IDebugReference2

  • Artikel

Diese Schnittstelle stellt einen Verweis auf eine Stapelframeeigenschaft oder eine andere Eigenschaft dar.

Hinweis

IDebugReference2 ist für die zukünftige Verwendung reserviert, und alle zugehörigen Methoden sollten zurückgegeben werden E_NOTIMPL.

Syntax

IDebugReference2 : IUnknown

Hinweise für Implementierer

Die DE implementiert diese Schnittstelle, um einen Verweis auf eine bestimmte Art von Wert darzustellen. Beispielsweise könnte der Wert ein numerischer Wert als Ergebnis einer Ausdrucksauswertung, eines Speicherkontexts sein, der zum Anzeigen des Arbeitsspeichers verwendet wird, oder eine Liste der Register und deren Werte.

Hinweise für Aufrufer

Rufen Sie GetReference auf, um diese Schnittstelle abzurufen. GetParent und GetDerivedMostReference geben auch diese Schnittstelle zurück.

Methoden in Vtable-Reihenfolge

In der folgenden Tabelle sind die Methoden von IDebugReference2 aufgeführt.

Methode Beschreibung
GetReferenceInfo Ruft die DEBUG_REFERENCE_INFO Struktur ab, die diesen Verweis beschreibt.
SetValueAsString Legt den Wert dieses Verweises aus einer Zeichenfolge fest.
SetValueAsReference Legt den Wert dieses Verweises aus einem anderen Verweis fest.
EnumChildren Listet die untergeordneten Elemente dieses Verweises auf.
GetParent Ruft das übergeordnete Element dieses Verweises ab.
GetDerivedMostReference Ruft den abgeleiteten Verweis dieses Verweises ab.
GetMemoryBytes Ruft die Speicherbytes ab, auf die dieser Verweis verweist.
GetMemoryContext Ruft einen Speicherkontext für diese Referenz ab.
GetSize Ruft die Größe in Bytes dieses Verweises ab.
SetReferenceType Legt diesen Verweistyp fest.
Vergleichen Vergleicht diesen Verweis mit einem anderen.

Hinweise

Hinweis

Diese Verwendung von "Property" sollte nicht mit der Bedeutung einer Membervariable einer Klasse verwechselt werden, obwohl eine IDebugReference2 solche Entität darstellen kann.

  • IDebugProperty2 stellt eine Eigenschaft dar, während IDebugReference2 ein Verweis auf eine Eigenschaft darstellt, in der Regel ein Verweis auf ein Objekt im Programm, das gedebuggt wird.

Der Standard Unterschied zwischen einer Eigenschaft und einem Verweis besteht darin, dass eine Eigenschaft auf eine benannte Instanz eines Objekts verweist, während ein Verweis auf eine unbenannte Instanz verweist. Eine Eigenschaft kann z. B. auf ein Objekt im Heap des Programms verweisen."a.b" Eine andere Eigenschaft kann auf dasselbe Objekt verweisen wie "c.d". Die Art und Weise, auf diese Eigenschaft zu verweisen, erfordert dies "a.b" oder "c.d" liegt im Gültigkeitsbereich. Ein Verweis auf dieses Objekt ist ohne Namen; das Objekt kann so lange bezeichnet werden, wie der Speicher für dieses Objekt gültig ist.

Eine IDebugProperty2 Schnittstelle kann als Wert mit einem Namen, einem Typ und einer Adresse betrachtet werden. Eine IDebugReference2, auf der anderen Seite kann als Typ und Adresse betrachtet werden.

Anforderungen

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Siehe auch