IDebugReference2
Questa interfaccia rappresenta un riferimento a una proprietà stack frame o a un'altra proprietà.
Nota
IDebugReference2 è riservato per un uso futuro e tutti i relativi metodi devono restituire E_NOTIMPL.
Sintassi
IDebugReference2 : IUnknown
Note per gli implementatori
La de implementa questa interfaccia per rappresentare un riferimento a un particolare tipo di valore. Ad esempio, il valore potrebbe essere un valore numerico in seguito a una valutazione dell'espressione, un contesto di memoria usato per visualizzare la memoria o un elenco di registri e i relativi valori.
Note per i chiamanti
Chiamare GetReference per ottenere questa interfaccia. GetParent e GetDerivedMostReference restituiscono anche questa interfaccia.
Metodi nell'ordine Vtable
Nella tabella seguente vengono illustrati i metodi di IDebugReference2.
| metodo | Descrizione |
|---|---|
| GetReferenceInfo | Ottiene la struttura DEBUG_REFERENCE_INFO che descrive questo riferimento. |
| SetValueAsString | Imposta il valore di questo riferimento da una stringa. |
| SetValueAsReference | Imposta il valore di questo riferimento da un altro riferimento. |
| EnumChildren | Enumera gli elementi figlio di questo riferimento. |
| GetParent | Ottiene l'elemento padre di questo riferimento. |
| GetDerivedMostReference | Ottiene il riferimento più derivato di questo riferimento. |
| GetMemoryBytes | Ottiene i byte di memoria a cui fa riferimento questo riferimento. |
| GetMemoryContext | Ottiene un contesto di memoria per questo riferimento. |
| GetSize | Ottiene le dimensioni, in byte, di questo riferimento. |
| SetReferenceType | Imposta questo tipo di riferimento. |
| Confronta | Confronta questo riferimento con un altro. |
Osservazioni:
Nota
Questo uso di "proprietà" non deve essere confuso con questo significato con una variabile membro di una classe, anche se un IDebugReference2 può rappresentare tale entità.
- IDebugProperty2 rappresenta una proprietà, mentre
IDebugReference2rappresenta un riferimento a una proprietà, in genere un riferimento a un oggetto nel programma sottoposto a debug.
La differenza principale tra una proprietà e un riferimento è che una proprietà fa riferimento a un'istanza denominata di un oggetto, mentre un riferimento fa riferimento a un'istanza senza nome. Ad esempio, una proprietà può fare riferimento a un oggetto nell'heap del programma da "a.b". Un'altra proprietà può fare riferimento allo stesso oggetto di "c.d". Il modo di fare riferimento a questa proprietà richiede che "a.b" o "c.d" sia nell'ambito. Un riferimento a questo stesso oggetto è senza nome; L'oggetto può essere definito a condizione che la memoria per tale oggetto sia valida.
Un'interfaccia IDebugProperty2 può essere considerata come un valore con un nome, un tipo e un indirizzo. Un IDebugReference2oggetto , d'altra parte, può essere considerato come un tipo e un indirizzo.
Requisiti
Intestazione: msdbg.h
Spazio dei nomi: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll