共用方式為


IDebugReference2

這個介面代表堆疊框架屬性或其他屬性的參考。

注意

IDebugReference2 保留供日後使用,而且其所有方法都應該傳回 E_NOTIMPL

語法

IDebugReference2 : IUnknown

實作者的注意事項

DE 會實作這個介面來表示特定值類型的參考。 例如,這個值可能是表達式評估、用於顯示記憶體的記憶體內容,或是緩存器及其值清單的結果。

呼叫端注意事項

呼叫 GetReference 以取得這個介面。 GetParentGetDerivedMostReference 也會傳回這個介面。

依照 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

另請參閱