ICorDebugProcess2::GetReferenceValueFromGCHandle-Methode

Ruft einen Verweiszeiger auf das angegebene verwaltete Objekt ab, das über ein Garbage Collection-Handle verfügt.

Syntax

HRESULT GetReferenceValueFromGCHandle (
    [in]  UINT_PTR                 handle,
    [out] ICorDebugReferenceValue  **pOutValue
);

Die Parameter

handle [in] Ein Zeiger auf ein verwaltetes Objekt mit einem Garbage Collection-Handle. Dieser Wert ist ein IntPtr Objekt und kann aus dem GCHandle für das verwaltete Objekt abgerufen werden.

pOutValue [out] Ein Zeiger auf die Adresse eines ICorDebugReferenceValue-Objekts, das einen Verweis auf das angegebene verwaltete Objekt darstellt.

Bemerkungen

Verwechseln Sie den zurückgegebenen Verweiswert nicht mit einem Garbage Collection-Verweiswert.

Der zurückgegebene Verweis verhält sich wie ein normaler Bezug. Sie ist deaktiviert, wenn die Codeausführung nach einem Haltepunkt fortgesetzt wird. Die Lebensdauer des Zielobjekts wird von der Lebensdauer des Referenzwerts nicht beeinflusst.

Hinweis

Die GetReferenceValueFromGCHandle Methode überprüft das Handle nicht. Daher kann die GetReferenceValueFromGCHandle Methode sowohl den Debugger als auch den code, der gedebuggt wird, möglicherweise beschädigt werden, wenn ein ungültiger Handle übergeben wird.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET-Versionen: Verfügbar seit .NET Framework 2.0