Método ICorDebugThread::GetCurrentException

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

Sintaxe

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

Parâmetros

ppExceptionObject [out] Um ponteiro para o endereço de um ICorDebugValue objeto que representa a exceção que está sendo lançada no momento 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 o restaurará após a 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 é gerada, o CLR (Common Language Runtime) pode ficar sem memória e promovê-lo a uma exceção fora da memória.

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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