IDebugReference2

Articolo
05/17/2015

Questa interfaccia rappresenta un riferimento a una proprietà dello stack frame o a un'altra proprietà.

Nota

IDebugReference2 è riservato per un utilizzo futuro e tutti i metodi restituiscono E_NOTIMPL.

IDebugReference2 : IUnknown

Note per gli implementatori

Il DE implementa questa interfaccia per rappresentare un riferimento a un particolare tipo di valore. Ad esempio, il valore può essere un valore numerico come risultato della valutazione di un'espressione, di un contesto di memoria utilizzato per la visualizzazione della memoria, o un elenco di log e i relativi valori.

Note per i chiamanti

Chiamare IDebugProperty2:: GetReference per ottenere questa interfaccia. IDebugReference2:: GetParent anche IDebugReference2:: GetDerivedMostReference e restituire questa interfaccia.

Metodi nell'ordine di Vtable

Nella tabella seguente sono elencati i metodi di IDebugReference2.

Metodo	Descrizione
IDebugReference2:: GetReferenceInfo	Ottiene DEBUG_REFERENCE_INFORMATION la struttura che descrive il riferimento.
IDebugReference2:: SetValueAsString	Imposta il valore di questo riferimento da una stringa.
IDebugReference2:: SetValueAsReference	Imposta il valore di questo riferimento da un altro riferimento.
IDebugReference2:: EnumChildren	Enumera gli elementi figlio di questo riferimento.
IDebugReference2:: GetParent	Ottiene l'elemento padre di questo riferimento.
IDebugReference2:: GetDerivedMostReference	Ottiene il riferimento maggiormente derivato del riferimento.
IDebugReference2:: GetMemoryBytes	ottiene i byte di memoria a cui questo riferimento si riferisce.
IDebugReference2:: GetMemoryContext	Ottiene un contesto di memoria di questo riferimento.
IDebugReference2:: GetSize	Ottiene la dimensione, in byte, del riferimento.
IDebugReference2:: SetReferenceType	Imposta questo tipo di riferimento.
IDebugReference2:: confrontare	Confronta questo riferimento a un altro.

Note

Nota

Questo utilizzo di “proprietà„ non deve essere confuso con tale significato una variabile membro di una classe, sebbene IDebugReference2 può rappresentare una tale entità.

IDebugProperty2 rappresenta una proprietà, mentre IDebugReference2 rappresenta 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". La modalità di fare riferimento a questa proprietà richiede tale "a.b" o "c.d"ambito. Un riferimento allo stesso oggetto è senza nome; l'oggetto può fare riferimento a condizione che la memoria per tale oggetto è valida.

Un'interfaccia di IDebugProperty2 può essere considerata come un valore con un nome, un tipo e un indirizzo. IDebugReference2, invece, può essere considerato come un tipo e un indirizzo.