IDebugReference2IDebugReference2

Essa interface representa uma referência a uma propriedade de quadro de pilha ou outra propriedade.This interface represents a reference to a stack frame property or some other property.

Note

IDebugReference2 é reservado para uso futuro e todos os seus métodos devem retornar E_NOTIMPL.IDebugReference2 is reserved for future use, and all its methods should return E_NOTIMPL.

SintaxeSyntax

IDebugReference2 : IUnknown

Observações para implementadoresNotes for Implementers

O DE implementa essa interface para representar uma referência a um determinado tipo de valor.The DE implements this interface to represent a reference to a particular kind of value. Por exemplo, o valor pode ser um valor numérico como resultado de uma avaliação de expressão, um contexto de memória usado para exibir a memória ou uma lista de registros e seus valores.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.

Observações para chamadoresNotes for Callers

Chame GetReference para obter essa interface.Call GetReference to obtain this interface. GetParent e GetDerivedMostReference também retornar essa interface.GetParent and GetDerivedMostReference also return this interface.

Métodos na ordem de VtableMethods in Vtable Order

A tabela a seguir mostra os métodos de IDebugReference2.The following table shows the methods of IDebugReference2.

MétodoMethod DescriçãoDescription
GetReferenceInfoGetReferenceInfo Obtém o DEBUG_REFERENCE_INFO estrutura que descreve esta referência.Gets the DEBUG_REFERENCE_INFO structure that describes this reference.
SetValueAsStringSetValueAsString Define o valor dessa referência de uma cadeia de caracteres.Sets the value of this reference from a string.
SetValueAsReferenceSetValueAsReference Define o valor dessa referência de outra referência.Sets the value of this reference from another reference.
EnumChildrenEnumChildren Enumera os filhos dessa referência.Enumerates the children of this reference.
GetParentGetParent Obtém o pai dessa referência.Gets the parent of this reference.
GetDerivedMostReferenceGetDerivedMostReference Obtém a referência mais derivada dessa referência.Gets the most-derived reference of this reference.
GetMemoryBytesGetMemoryBytes Obtém os bytes de memória ao qual esta referência se refere.Gets the memory bytes to which this reference refers.
GetMemoryContextGetMemoryContext Obtém um contexto de memória para esta referência.Gets a memory context for this reference.
GetSizeGetSize Obtém o tamanho, em bytes, dessa referência.Gets the size, in bytes, of this reference.
SetReferenceTypeSetReferenceType Define este tipo de referência.Sets this reference type.
CompareCompare Compara essa referência com outra.Compares this reference with another.

ComentáriosRemarks

Note

Esse uso de "property" não deve ser confundido com esse que significa que uma variável de membro de uma classe, embora um IDebugReference2 pode representar essa entidade.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 representa uma propriedade, enquanto IDebugReference2 representa uma referência a uma propriedade, normalmente uma referência a um objeto no programa que está sendo depurado.IDebugProperty2 represents a property, while IDebugReference2 represents a reference to a property, typically a reference to an object in the program being debugged.

A principal diferença entre uma propriedade e uma referência é que uma propriedade se refere a uma instância nomeada de um objeto, enquanto uma referência se refere a uma instância sem nome.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. Por exemplo, uma propriedade pode se referir a um objeto no heap do programa por "a.b".For example, a property may refer to an object in the program's heap by "a.b". Outra propriedade pode se referir ao mesmo objeto como "c.d".Another property may refer to the same object as "c.d". A maneira de se referir a essa propriedade requer que "a.b" ou "c.d" estar no escopo.The way of referring to this property requires that "a.b" or "c.d" be in scope. Uma referência a esse mesmo objeto é sem nome; o objeto pode ser referenciado como a memória para esse objeto é válida.A reference to this same object is nameless; the object can be referred to as long as the memory for that object is valid.

Um IDebugProperty2 interface pode ser pensada como um valor com um nome, um tipo e um endereço.An IDebugProperty2 interface can be thought of as a value with a name, a type, and an address. Um IDebugReference2, por outro lado, pode ser pensada como um tipo e um endereço.An IDebugReference2, on the other hand, can be thought of as a type and an address.

RequisitosRequirements

Header: msdbg.hHeader: msdbg.h

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

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

Consulte tambémSee also