ICorDebugProcess2::GetReferenceValueFromGCHandle-metod

Hämtar en referenspekare till det angivna hanterade objektet som har ett skräpinsamlingshandtag.

Syntax

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

Parameterar

handle [i] En pekare till ett hanterat objekt som har ett skräpinsamlingshandtag. Det här värdet är ett IntPtr objekt och kan hämtas från GCHandle för det hanterade objektet.

pOutValue [ut] En pekare till adressen för ett ICorDebugReferenceValue-objekt som representerar en referens till det angivna hanterade objektet.

Anmärkningar

Förväxla inte det returnerade referensvärdet med ett skräpinsamlingsreferensvärde.

Den returnerade referensen fungerar som en normal referens. Den inaktiveras när kodkörningen fortsätter efter en brytpunkt. Målobjektets livslängd påverkas inte av referensvärdets livslängd.

Anmärkning

Metoden GetReferenceValueFromGCHandle verifierar inte handtaget. GetReferenceValueFromGCHandle Därför kan metoden potentiellt skada både felsökaren och koden som debuggas om ett ogiltigt handtag skickas.

Kravspecifikation

Plattformar: Se Operativsystem som stöds av .NET.

Rubrik: CorDebug.idl, CorDebug.h

Bibliotek: CorGuids.lib

.NET-versioner: Tillgänglig sedan .NET Framework 2.0