ICorDebugProcess2::GetReferenceValueFromGCHandle (Método)

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

Syntax

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

Parámetros

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

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

Observaciones

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 del 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 GetReferenceValueFromGCHandle método no valida el identificador. Por lo tanto, el GetReferenceValueFromGCHandle método puede dañar potencialmente tanto el depurador como el código que se está depurando si se pasa un identificador no válido.

Requisitos

Plataformas: Consulte Sistemas operativos compatibles con .NET.

Encabezado: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versiones de .NET: Disponible desde .NET Framework 2.0