這個介面代表堆疊框架屬性或其他屬性的參考。
注意
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