ICorDebugProcess2::GetReferenceValueFromGCHandle (Método)

Artículo
08/10/2011

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

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 objeto IntPtr y se puede recuperar desde el GCHandle del 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 la recolección de elementos no utilizados.

El valor devuelto 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. El período de duración del objeto de destino no se ve afectado por el del valor de referencia.

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