ICorDebugProcess2::GetReferenceValueFromGCHandle (Método)

Obtiene un puntero de referencia al objeto administrado especificado que tiene un manipulador de recolección de elementos no utilizados.

Sintaxis

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

Parámetros

handle
[in] Puntero a un objeto administrado que tiene un manipulador de recolección de elementos no utilizados. Este valor es un objeto IntPtr y se puede recuperar de GCHandle para el objeto administrado.

pOutValue
[out] Puntero a la dirección de un objeto ICorDebugReferenceValue que representa una referencia al objeto administrado especificado.

Comentarios

No confunda el valor de referencia devuelto con un valor de referencia de recolección de elementos no utilizados.

La referencia devuelta se comporta como una referencia normal. Se deshabilita cuando la ejecución de código continúa después de un punto de interrupción. La duración del objeto de destino no se ve afectada por la duración del valor de referencia.

Nota

El método GetReferenceValueFromGCHandle no valida el manipulador. Por lo tanto, el método GetReferenceValueFromGCHandle puede dañar potencialmente tanto el depurador como el código que se está depurando si se pasa un manipulador no válido.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versiones de .NET Framework: disponible a partir de la versión 2.0