IDebugReference2

Artikel
05/16/2015

Diese Schnittstelle stellt einen Verweis auf eine Stapelrahmen - Eigenschaft oder einer anderen Eigenschaft dar.

Hinweis

IDebugReference2 ist für eine zukünftige Verwendung reserviert und alle zugehörigen Methoden sollten E_NOTIMPLzurückgeben.

IDebugReference2 : IUnknown

Hinweise für Implementierer

DE implementiert diese Schnittstelle, um einen Verweis auf eine bestimmte Weise Wert darstellt. Beispielsweise könnte der Wert eines numerischen Werts aufgrund einer Ausdrucksauswertung, einem Speicher, der für die Anzeige des Arbeitsspeichers verwendet wurden, oder eine Liste von Registern und deren Werte sein.

Hinweise für Aufrufer

IDebugProperty2::GetReference Aufruf zum Abrufen dieser Schnittstelle. IDebugReference2::GetParent und IDebugReference2::GetDerivedMostReference hinaus geben diese Schnittstelle zurück.

Methoden in die Vtable-Reihenfolge

In der folgenden Tabelle werden die Methoden von IDebugReference2an.

Methode	Beschreibung
IDebugReference2::GetReferenceInfo	Ruft die DEBUG_REFERENCE_INFORMATION Struktur ab, die diesen Verweis beschreibt.
IDebugReference2::SetValueAsString	Legt den Wert dieses Verweises aus einer Zeichenfolge fest.
IDebugReference2::SetValueAsReference	Legt den Wert dieses Verweises auf einen anderen Verweis fest.
IDebugReference2::EnumChildren	Listet die untergeordneten Elemente dieses Verweises auf.
IDebugReference2::GetParent	Ruft das übergeordnete Element dieses Verweises ab.
IDebugReference2::GetDerivedMostReference	Ruft den höchst-abgeleiteten Verweis dieses Verweises ab.
IDebugReference2::GetMemoryBytes	Ruft die Bytes an Arbeitsspeicher ab, auf den dieser Verweis verweist.
IDebugReference2::GetMemoryContext	Ruft einen Speicher als Elementkontext dieser Referenz ab.
IDebugReference2::GetSize	Ruft die Größe (in Bytes) des Verweises ab.
IDebugReference2::SetReferenceType	Legt den Referenztyp fest.
IDebugReference2::Vergleichen	Vergleicht diesen Verweis mit einem anderen.

Hinweise

Hinweis

Dieser Verwendung von „Eigenschaft“ sollte nicht zu verwechseln mit dieser Bedeutung einer Membervariablen einer Klasse, obwohl IDebugReference2 eine solche Entität darstellen kann.

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

Der Hauptunterschied zwischen einer Eigenschaft und einem Verweis ist, dass eine Eigenschaft einer benannten Instanz eines Objekts als Verweis auf eine unbenannte Instanz verweist. Zum Beispiel kann eine Eigenschaft verweist auf ein Objekt im Heap des Programms durch "a.b"an. Eine andere Eigenschaft verweist möglicherweise das gleiche Objekt wie "c.d"an. Die Möglichkeit des erhöhen, auf dieser Eigenschaft erfordert dieses "a.b" , oder "c.d" ist im Bereich. Ein Verweis auf dieses Objekt denselben namenlos ist. Es kann das verwiesen wird, sofern der Speicher für dieses Objekt gültig ist.

Eine IDebugProperty2-Schnittstelle kann als Wert betrachtet werden mit einem Namen, einem Typ und einer angegebenen Adresse. IDebugReference2kann für einen Typ und eine Adresse dagegen beibehalten werden.