Compartilhar via


Método ICorDebugThread::GetCurrentException

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

Sintaxe

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

Parâmetros

ppExceptionObject [fora] 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.

Comentários

O objeto de exceção existirá do momento em que a exceção for gerada até o final do bloco catch. Uma avaliação de função, que é executada pelos métodos ICorDebugEval, limpará o objeto de exceção na configuração e o restaurará após a conclusão.

As exceções poderão ser aninhadas (por exemplo, se uma exceção for gerada em um filtro ou em uma avaliação de função), portanto, poderá 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 poderão alterar ao longo da vida da exceção. Por exemplo, após uma exceção do tipo x ser gerada, o CLR (Common Language Runtime) poderá ficar sem memória e promovê-la a uma exceção de memória insuficiente.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponíveis desde a versão 1.0