IDebugReference2
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
IDebugReference2ein 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