IDebugReference2IDebugReference2

Cette interface représente une référence à une propriété de frame de pile ou une autre propriété.This interface represents a reference to a stack frame property or some other property.

Note

IDebugReference2 est réservé pour une utilisation ultérieure et tous ses méthodes doivent retourner E_NOTIMPL.IDebugReference2 is reserved for future use, and all its methods should return E_NOTIMPL.

SyntaxeSyntax

IDebugReference2 : IUnknown  

Notes pour les implémenteursNotes for Implementers

Le D’implémente cette interface pour représenter une référence à un type particulier de valeur.The DE implements this interface to represent a reference to a particular kind of value. Par exemple, la valeur peut être une valeur numérique à la suite d’une évaluation d’expression, un contexte de la mémoire utilisée pour l’affichage de mémoire ou une liste des registres et leurs valeurs.For example, the value could be a numerical value as a result of an expression evaluation, a memory context used for displaying memory, or a list of registers and their values.

Remarques pour les appelantsNotes for Callers

Appelez GetReference pour obtenir cette interface.Call GetReference to obtain this interface. GetParent et GetDerivedMostReference également retourner cette interface.GetParent and GetDerivedMostReference also return this interface.

Méthodes dans l'ordre VtableMethods in Vtable Order

Le tableau suivant présente les méthodes de IDebugReference2.The following table shows the methods of IDebugReference2.

MéthodeMethod DescriptionDescription
GetReferenceInfoGetReferenceInfo Obtient le DEBUG_REFERENCE_INFO structure qui décrit cette référence.Gets the DEBUG_REFERENCE_INFO structure that describes this reference.
SetValueAsStringSetValueAsString Définit la valeur de cette référence à partir d’une chaîne.Sets the value of this reference from a string.
SetValueAsReferenceSetValueAsReference Définit la valeur de cette référence à partir d’une autre référence.Sets the value of this reference from another reference.
EnumChildrenEnumChildren Énumère les enfants de cette référence.Enumerates the children of this reference.
GetParentGetParent Obtient le parent de cette référence.Gets the parent of this reference.
GetDerivedMostReferenceGetDerivedMostReference Obtient la référence de la plus dérivée de cette référence.Gets the most-derived reference of this reference.
GetMemoryBytesGetMemoryBytes Obtient les octets de mémoire à laquelle cette référence fait référence.Gets the memory bytes to which this reference refers.
GetMemoryContextGetMemoryContext Obtient un contexte de la mémoire pour cette référence.Gets a memory context for this reference.
GetSizeGetSize Obtient la taille, en octets, de cette référence.Gets the size, in bytes, of this reference.
SetReferenceTypeSetReferenceType Définit ce type de référence.Sets this reference type.
CompareCompare Compare cette référence avec un autre.Compares this reference with another.

NotesRemarks

Note

Cette utilisation de « propriété » ne doit pas être confondue avec cette variable de membre d’une classe, ce qui signifie que même si un IDebugReference2 peut représenter une telle entité.This use of "property" should not be confused with that meaning a member variable of a class, although an IDebugReference2 can represent such an entity.

IDebugProperty2 représente une propriété, tandis que IDebugReference2 représente une référence à une propriété, en général, une référence à un objet dans le programme en cours de débogage.IDebugProperty2 represents a property, while IDebugReference2 represents a reference to a property, typically a reference to an object in the program being debugged.

La principale différence entre une propriété et une référence est qu’une propriété fait référence à une instance nommée d’un objet, tandis qu’une référence à une instance sans nom.The main difference between a property and a reference is that a property refers to a named instance of an object, while a reference refers to an unnamed instance. Par exemple, une propriété peut faire référence à un objet dans le tas du programme par "a.b".For example, a property may refer to an object in the program's heap by "a.b". Une autre propriété peut faire référence au même objet en tant que "c.d".Another property may refer to the same object as "c.d". La façon de faire référence à cette propriété requiert que "a.b" ou "c.d" être dans la portée.The way of referring to this property requires that "a.b" or "c.d" be in scope. Une référence à ce même objet est sans nom ; l’objet peut être référencé tant que la mémoire pour cet objet est valide.A reference to this same object is nameless; the object can be referred to as long as the memory for that object is valid.

Un IDebugProperty2 interface peut être considéré comme une valeur avec un nom, un type et une adresse.An IDebugProperty2 interface can be thought of as a value with a name, a type, and an address. Un IDebugReference2sur l’autre revanche, peut être considéré comme un type et une adresse.An IDebugReference2, on the other hand, can be thought of as a type and an address.

SpécificationsRequirements

En-tête : msdbg.hHeader: msdbg.h

Namespace : Microsoft.VisualStudio.Debugger.InteropNamespace: Microsoft.VisualStudio.Debugger.Interop

Assembly : Microsoft.VisualStudio.Debugger.Interop.dllAssembly: Microsoft.VisualStudio.Debugger.Interop.dll

Voir aussiSee Also

Interfaces de base Core Interfaces
DEBUG_REFERENCE_INFO DEBUG_REFERENCE_INFO
IDebugProperty2 IDebugProperty2
GetReferenceGetReference