Freigeben über

ICorDebugProcess2::GetReferenceValueFromGCHandle-Methode

  • Artikel

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
);

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.

Hinweise

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

Der zurückgegebene Verweis verhält sich wie ein normaler Verweis. Er wird 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 möglicherweise sowohl den Debugger als auch den zu debuggenden Code beschädigen, wenn ein ungültiges Handle übergeben wird.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit 2.0 verfügbar.