ICorDebugProcess2::GetReferenceValueFromGCHandle — Metoda

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 / Notatka

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.

Requirements

Platformy: Zobacz Obsługiwane systemy operacyjne platformy .NET.

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

Biblioteka: CorGuids.lib

Wersje platformy .NET: Dostępne od programu .NET Framework 2.0