Método ICorDebugProcess2::GetReferenceValueFromGCHandle

Obtém um ponteiro de referência para o objeto gerenciado especificado que tem um lixo coleção manipular.

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

Parâmetros

handle
[in] Um ponteiro para um objeto gerenciado possui um lixo coleção manipular. Esse valor é um IntPtr objeto e podem ser recuperados das GCHandle objeto gerenciado.
pOutValue
[out] Um ponteiro para o endereço de um ICorDebugReferenceValue objeto que representa uma referência ao objeto gerenciado especificado.

Comentários

Não confunda o valor da referência fornecida com um valor de referência de coleta de lixo.

A referência fornecida se comporta como uma referência normal. Quando a execução de código continua após um ponto de interrupção está desabilitado. O tempo de vida do objeto de destino não é afetado pela vida útil do valor de referência.

Observação:
O GetReferenceValueFromGCHandle método não valida a alça. Portanto, a GetReferenceValueFromGCHandle método potencialmente pode corromper o depurador e o código que está sendo depurado se um identificador inválido for passado.