IDebugReference2
這個介面代表堆疊框架屬性或其他屬性的參考。
注意
IDebugReference2
保留供日後使用,而且其所有方法都應該傳回 E_NOTIMPL
。
語法
IDebugReference2 : IUnknown
實作者的注意事項
DE 會實作這個介面來表示特定值類型的參考。 例如,這個值可能是表達式評估、用於顯示記憶體的記憶體內容,或是緩存器及其值清單的結果。
呼叫端注意事項
呼叫 GetReference 以取得這個介面。 GetParent 和 GetDerivedMostReference 也會傳回這個介面。
依照 Vtable 順序的方法
下表顯示 IDebugReference2
方法。
方法 | 描述 |
---|---|
GetReferenceInfo | 取得描述 這個參考的DEBUG_REFERENCE_INFO 結構。 |
SetValueAsString | 從字串設定這個參考的值。 |
SetValueAsReference | 從另一個參考設定這個參考的值。 |
EnumChildren | 列舉這個參考的子系。 |
GetParent | 取得這個參考的父系。 |
GetDerivedMostReference | 取得這個參考的最衍生參考。 |
GetMemoryBytes | 取得這個參考所參考的記憶體位元組。 |
GetMemoryContext | 取得這個參考的記憶體內容。 |
GetSize | 取得這個參考的大小,以位元組為單位。 |
SetReferenceType | 設定這個參考類型。 |
比較 | 比較此參考與另一個參考。 |
備註
注意
雖然 可以表示這類實體, IDebugReference2
但這種使用 「property」 不應與這表示類別的成員變數混淆。
- IDebugProperty2 代表屬性,而
IDebugReference2
代表屬性的參考,通常是正在偵錯之程式中對象的參考。
屬性與參考之間的主要差異在於屬性參考物件的具名實例,而參考則參考未命名的實例。 例如,屬性可能會參考程序堆積 "a.b"
中的物件。 另一個屬性可能參考與 "c.d"
相同的物件。 參考這個屬性的方式需要或"a.b"
"c.d"
是在範圍內。 這個相同對象的參考是無名稱的;只要該物件的記憶體有效,就可以將 物件稱為 。
IDebugProperty2
介面可以視為名稱、類型和位址的值。 另一 IDebugReference2
方面,可以將 視為型別和位址。
需求
標頭:msdbg.h
命名空間:Microsoft.VisualStudio.Debugger.Interop
元件:Microsoft.VisualStudio.Debugger.Interop.dll