Método ICorDebugProcess2::GetReferenceValueFromGCHandle

Obtém um ponteiro de referência para o objeto gerenciado especificado que tem um identificador de coleta de lixo.

Sintaxe

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

Parâmetros

handle [em] Um ponteiro para um objeto gerenciado que tem um identificador de coleta de lixo. Esse valor é um IntPtr objeto e pode ser recuperado do GCHandle para o objeto gerenciado.

pOutValue [saídas] Um ponteiro para o endereço de um ICorDebugReferenceValue objeto que representa uma referência para o objeto gerenciado especificado.

Observações

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

A referência retornada se comporta como uma referência normal. Ele é desativado quando a execução de código continua após um ponto de interrupção. O tempo de vida do objeto de destino não é afetado pelo tempo de vida do valor de referência.

Observação

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

Requerimentos

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões .NET: Disponível desde: .NET Framework 2.0