Método de ICorDebugProcess2::GetReferenceValueFromGCHandle

Artigo
08/08/2011

Obtém um ponteiro de referência para o objeto gerenciado especificado que possua uma coleta de lixo a alça.

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

Parâmetros

handle
[in] Um ponteiro para um objeto gerenciado que possui uma alça de coleta de lixo. Esse valor é um IntPtr object e podem ser recuperados a partir de GCHandle para o objeto gerenciado.
pOutValue
[out] Um ponteiro para o endereço de um ICorDebugReferenceValue o 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 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 a alça.Portanto, o GetReferenceValueFromGCHandle método potencialmente pode corromper o depurador e o código que está sendo depurado se um identificador inválido for passado.