Dela via

ICorDebugProcess2::GetReferenceValueFromGCHandle-metod

  • Artikel

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

Syntax

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

Parametrar

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.

Kommentarer

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.

Kommentar

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.

Krav

Plattformar: Se Systemkrav.

Rubrik: CorDebug.idl, CorDebug.h

Bibliotek: CorGuids.lib

.NET Framework-versioner: Tillgänglig sedan 2.0