ICorDebugReferenceValue

Actualización: noviembre 2007

Proporciona métodos que administran un valor que es una referencia a un objeto. (Es decir, esta interfaz proporciona métodos que administran un puntero.) Esta interfaz implementa 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
    );
        
};

Métodos

Método	Descripción
ICorDebugReferenceValue::Dereference (Método)	Obtiene el objeto al que se hace referencia.
ICorDebugReferenceValue::DereferenceStrong (Método)	Sin implementar. No llame a este método.
ICorDebugReferenceValue::GetValue (Método)	Obtiene la dirección de memoria actual del objeto al que se hace referencia.
ICorDebugReferenceValue::IsNull (Método)	Obtiene un valor que indica si este ICorDebugReferenceValue es un valor nulo, en cuyo caso ICorDebugReferenceValue no señala a un objeto.
ICorDebugReferenceValue::SetValue (Método)	Establece la dirección de memoria actual. Es decir, este método establece este ICorDebugReferenceValue para señalar a un objeto.

Comentarios

Common Language Runtime (CLR) puede realizar una recolección de elementos no utilizados en objetos cuando continúa el proceso depurado. La recolección de elementos no utilizados puede mover objetos en la memoria. Un ICorDebugReferenceValue colaborará con la recolección de elementos no utilizados para que la información se actualice después de la misma o se invalidará implícitamente antes de que se produzca.

El objeto ICorDebugReferenceValue se puede invalidar implícitamente después de que continúe el proceso depurado. El ICorDebugHandleValue derivado no se invalida hasta que se libere o se exponga explícitamente.