ICorDebugReferenceValue

Article
08/21/2008

Mise à jour : novembre 2007

Fournit des méthodes qui gèrent une valeur qui est une référence à un objet. (Autrement dit, cette interface fournit des méthodes qui gèrent un pointeur.) Cette interface implémente 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éthodes

Méthode	Description
ICorDebugReferenceValue::Dereference, méthode	Obtient l'objet qui est référencé.
ICorDebugReferenceValue::DereferenceStrong, méthode	Pas implémenté. N'appelez pas cette méthode.
ICorDebugReferenceValue::GetValue, méthode	Obtient l'adresse mémoire actuelle de l'objet référencé.
ICorDebugReferenceValue::IsNull, méthode	Obtient une valeur qui indique si ICorDebugReferenceValue est une valeur null, auquel cas ICorDebugReferenceValue ne pointe pas vers un objet.
ICorDebugReferenceValue::SetValue, méthode	Définit l'adresse mémoire actuelle. Autrement dit, cette méthode définit ICorDebugReferenceValue de façon à pointer vers un objet.

Notes

Le Common Language Runtime (CLR) peut effectuer un garbage collection sur les objets lors de la poursuite du processus débogué. Le garbage collection peut déplacer les objets dans la mémoire. ICorDebugReferenceValue coopérera avec les garbage collections pour que les informations soient mises à jour après le garbage collection, ou sera invalidé implicitement avant le garbage collection.

L'objet ICorDebugReferenceValue peut être invalidée implicitement après la poursuite du processus débogué. Le ICorDebugHandleValue dérivé n'est pas invalidé tant qu'il n'a pas été explicitement libéré ou exposé.