Interface ICorDebugReferenceValue

Artigo
08/25/2010

Fornece métodos que gerenciar um valor que é uma referência a um objeto. (Ou seja, essa interface fornece métodos que gerenciar um ponteiro.) Essa interface 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	Descrição
Método ICorDebugReferenceValue::desreferenciar	Obtém o objeto é referenciado.
Método ICorDebugReferenceValue::DereferenceStrong	Não implementado. Não chame este método.
Método ICorDebugReferenceValue::GetValue	Obtém o endereço de memória corrente do objeto referenciado.
Método ICorDebugReferenceValue::IsNull	Obtém um valor que indica se este ICorDebugReferenceValue é um valor nulo, caso em que o ICorDebugReferenceValue não faz referência a um objeto.
Método ICorDebugReferenceValue::SetValue	Define o endereço de memória corrente. Isto é, este método define esse ICorDebugReferenceValue para apontar para um objeto.

Comentários

O common linguagem tempo de execução (CLR) pode fazer um lixo coleção nos objetos quando o processo depurado é continuação. O lixo coleção mover objetos em torno de na memória. An ICorDebugReferenceValue será um cooperar com a coleta de lixo para que suas informações são atualizadas após a coleta de lixo, ou sejam invalidado implicitamente antes da coleta de lixo.

The ICorDebugReferenceValue objeto pode ser invalidado implicitamente depois continua o processo depurado. O derivadasICorDebugHandleValue não é invalidada até que seja liberado ou exposto explicitamente.