Compartilhar via

Método ICorDebugProcess2::GetReferenceValueFromGCHandle

  • Artigo

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 objeto gerenciado.

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

Comentários

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 é desabilitado quando a execução do 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.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 2.0