Condividi tramite

Metodo ICorDebugProcess2::GetReferenceValueFromGCHandle

  • Articolo

Ottiene un puntatore di riferimento all'oggetto gestito specificato con un handle di Garbage Collection.

Sintassi

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

Parametri

handle [in] Puntatore a un oggetto gestito con un handle di Garbage Collection. Questo valore è un IntPtr oggetto e può essere recuperato da GCHandle per l'oggetto gestito.

pOutValue [out] Puntatore all'indirizzo di un oggetto ICorDebugReferenceValue che rappresenta un riferimento all'oggetto gestito specificato.

Osservazioni:

Non confondere il valore di riferimento restituito con un valore di riferimento di Garbage Collection.

Il riferimento restituito si comporta come un riferimento normale. È disabilitato quando l'esecuzione del codice continua dopo un punto di interruzione. La durata dell'oggetto di destinazione non è influenzata dalla durata del valore di riferimento.

Nota

Il GetReferenceValueFromGCHandle metodo non convalida l'handle. Pertanto, il GetReferenceValueFromGCHandle metodo può potenzialmente danneggiare sia il debugger che il codice sottoposto a debug se viene passato un handle non valido.

Requisiti

Piattaforme: vedere Requisiti di sistema.

Intestazione: CorDebug.idl, CorDebug.h

Libreria: CorGuids.lib

Versioni di .NET Framework: disponibili dalla versione 2.0