Metodo ICorDebugProcess2::GetReferenceValueFromGCHandle

Articolo
08/11/2011

Ottiene un puntatore a riferimento all'oggetto gestito specificato che ha un handle di Garbage Collection.

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 oggetto IntPtr 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.

Note

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

Il riferimento restituito si comporta come un normale riferimento. Viene disabilitato quando l'esecuzione del codice continua dopo un punto di interruzione. Sulla vita dell'oggetto di destinazione non incide la vita del valore del riferimento.

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