Udostępnij za pośrednictwem

ICorDebugProcess2::GetReferenceValueFromGCHandle — Metoda

  • Artykuł

Pobiera wskaźnik odniesienia do określonego zarządzanego obiektu, który ma uchwyt odzyskiwania pamięci.

Składnia

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

Parametry

handle [in] Wskaźnik do zarządzanego obiektu, który ma uchwyt odzyskiwania pamięci. Ta wartość jest obiektem IntPtr i można go pobrać z GCHandle obiektu zarządzanego.

pOutValue [out] Wskaźnik do adresu obiektu ICorDebugReferenceValue, który reprezentuje odwołanie do określonego obiektu zarządzanego.

Uwagi

Nie należy mylić zwróconej wartości odwołania z wartością odwołania do odzyskiwania pamięci.

Zwrócone odwołanie zachowuje się jak normalne odwołanie. Jest ona wyłączona, gdy wykonywanie kodu będzie kontynuowane po punkcie przerwania. Okres istnienia obiektu docelowego nie ma wpływu na okres istnienia wartości referencyjnej.

Uwaga

Metoda GetReferenceValueFromGCHandle nie weryfikuje uchwytu. W związku z GetReferenceValueFromGCHandle tym metoda może potencjalnie uszkodzić debuger i debugowany kod, jeśli przekazano nieprawidłowy uchwyt.

Wymagania

Platformy: zobacz Wymagania systemowe.

Nagłówek: CorDebug.idl, CorDebug.h

Biblioteka: CorGuids.lib

Wersje programu .NET Framework: dostępne od wersji 2.0