Partilhar via


Método ICorDebugThread::GetCurrentException

Obtém um ponteiro de interface para um objeto ICorDebugValue que representa uma exceção que está sendo lançada atualmente pelo código gerenciado.

Sintaxe

HRESULT GetCurrentException (
    [out] ICorDebugValue **ppExceptionObject
);

Parâmetros

ppExceptionObject [saídas] Um ponteiro para o endereço de um ICorDebugValue objeto que representa a exceção que está sendo lançada atualmente pelo código gerenciado.

Observações

O objeto de exceção existirá a partir do momento em que a exceção for lançada até o final do catch bloco. Uma avaliação de função, que é executada pelos métodos ICorDebugEval, limpará o objeto de exceção na instalação e restaurá-lo-á na conclusão.

As exceções podem ser aninhadas (por exemplo, se uma exceção for lançada em um filtro ou em uma avaliação de função), portanto, pode haver várias exceções pendentes em um único thread. GetCurrentException retorna a exceção mais atual.

O objeto e o tipo de exceção podem mudar ao longo da vida útil da exceção. Por exemplo, depois que uma exceção do tipo x é lançada, o Common Language Runtime (CLR) pode ficar sem memória e promovê-lo para uma exceção de falta de memória.

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponível desde 1.0