ICorDebugProcess2::GetReferenceValueFromGCHandle-Methode

Artikel
08/10/2011

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

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

Parameter

handle
[in] Ein Zeiger auf ein verwaltetes Objekt, das über ein Garbage Collection-Handle verfügt. Dieser Wert ist ein IntPtr-Objekt und kann vom 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 ist deaktiviert, wenn die Codeausführung nach einem Haltepunkt fortgesetzt wird. Die Lebensdauer des Zielobjekts wird nicht von der Lebensdauer des Verweiswerts beeinflusst.

Hinweis
Die GetReferenceValueFromGCHandle-Methode überprüft das Handle nicht.Daher kann die GetReferenceValueFromGCHandle-Methode sowohl den Debugger als auch den gedebuggten Code beschädigen, wenn ein ungültiges Handle übergeben wird.