ICorDebugReferenceValue

發行項
08/21/2008

更新：2007 年 11 月

提供方法，可管理本身為物件參考的值 (也就是說，這個介面會提供管理指標的方法)。這個介面會實作 ICorDebugValue。

interface ICorDebugReferenceValue : ICorDebugValue {
        
    HRESULT Dereference (
        [out] ICorDebugValue  **ppValue
    );
        
    HRESULT DereferenceStrong (
        [out] ICorDebugValue  **ppValue
    );
        
    HRESULT GetValue (
        [out] CORDB_ADDRESS   *pValue
    );
        
    HRESULT IsNull (
        [out] BOOL            *pbNull
    );
        
    HRESULT SetValue (
        [in] CORDB_ADDRESS    value
    );
        
};

方法

方法	描述
ICorDebugReferenceValue::Dereference 方法	取得所參考的物件。
ICorDebugReferenceValue::DereferenceStrong 方法	尚未實作。請勿呼叫這個方法。
ICorDebugReferenceValue::GetValue 方法	取得所參考物件的目前記憶體位址。
ICorDebugReferenceValue::IsNull 方法	取得值，指出此 ICorDebugReferenceValue 是否為 null 值，在此情況下，ICorDebugReferenceValue 不會指向物件。
ICorDebugReferenceValue::SetValue 方法	設定目前的記憶體位址。也就是說，這個方法會設定此 ICorDebugReferenceValue 以指向物件。

備註

當經過偵錯的處理序繼續執行時，Common Language Runtime (CLR) 可能會對物件執行記憶體回收。記憶體回收可能會在記憶體中移動物件。ICorDebugReferenceValue 可能會與記憶體回收合作，如此便可在記憶體回收之後更新其資訊，或可能在記憶體回收之前隱含失效。

當經過偵錯的處理序繼續執行之後，ICorDebugReferenceValue 物件可能會隱含失效。衍生的 ICorDebugHandleValue 直到明確釋放或公開為止，都不會無效化。