ICorDebugReferenceValue

Artikel
09/02/2008

Aktualisiert: November 2007

Stellt Methoden zur Verwaltung eines Werts bereit, der ein Verweis auf ein Objekt ist. (Das heißt, diese Schnittstelle stellt Methoden bereit, die einen Zeiger verwalten.) Diese Schnittstelle implementiert 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
    );
        
};

Methoden

Methode	Beschreibung
ICorDebugReferenceValue::Dereference-Methode	Ruft das Objekt ab, auf das verwiesen wird.
ICorDebugReferenceValue::DereferenceStrong-Methode	Nicht implementiert. Rufen Sie diese Methode nicht auf.
ICorDebugReferenceValue::GetValue-Methode	Ruft die aktuelle Speicheradresse des Objekts ab, auf das verwiesen wird.
ICorDebugReferenceValue::IsNull-Methode	Ruft einen Wert ab, der angibt, ob dieser ICorDebugReferenceValue ein NULL-Wert ist; in diesem Fall verweist der ICorDebugReferenceValue nicht auf ein Objekt.
ICorDebugReferenceValue::SetValue-Methode	Legt die aktuelle Speicheradresse fest. Das heißt, diese Methode legt für diesen ICorDebugReferenceValue fest, dass er auf ein Objekt zeigt.

Hinweise

Die Common Language Runtime (CLR) führt möglicherweise eine Garbage Collection für Objekte durch, wenn der gedebuggte Prozess fortgesetzt wird. Die Garbage Collection verschiebt möglicherweise Objekte im Arbeitsspeicher. Ein ICorDebugReferenceValue arbeitet entweder mit der Garbage Collection zusammen, damit die Informationen nach der Garbage Collection aktualisiert werden, oder er wird implizit vor der Garbage Collection ungültig gemacht.

Das ICorDebugReferenceValue-Objekt wird möglicherweise implizit ungültig gemacht, nachdem der gedebuggte Prozess fortgesetzt wurde. Der abgeleitete ICorDebugHandleValue wird nicht ungültig gemacht, bevor er explizit freigegeben oder verfügbar gemacht wird.