IDebugExceptionEvent2
O mecanismo de depuração (DE) envia essa interface para o gerenciador de depuração de sessão (SDM) quando uma exceção é lançada no programa que está sendo executado no momento.
Sintaxe
IDebugExceptionEvent2 : IUnknown
Notas para implementadores
O DE implementa essa interface para relatar que ocorreu uma exceção no programa que está sendo depurado. A interface IDebugEvent2 deve ser implementada no mesmo objeto que essa interface. O SDM usa QueryInterface para acessar a IDebugEvent2 interface.
Observações para chamadores
O DE cria e envia esse objeto de evento para relatar uma exceção. O evento é enviado usando a função de retorno de chamada IDebugEventCallback2 que é fornecida pelo SDM quando ele se conectou ao programa que está sendo depurado.
Métodos na ordem VTable
A tabela a seguir mostra os métodos de IDebugExceptionEvent2.
| Método | Descrição |
|---|---|
| GetException | Obtém informações detalhadas sobre a exceção que disparou esse evento. |
| GetExceptionDescription | Obtém uma descrição legível por humanos para a exceção lançada que disparou esse evento. |
| CanPassToDebuggee | Determina se o mecanismo de depuração (DE) oferece suporte ou não à opção de passar essa exceção para o programa que está sendo depurado quando a execução for retomada. |
| PassToDebuggee | Especifica se a exceção deve ser passada para o programa que está sendo depurado quando a execução for retomada ou se a exceção deve ser descartada. |
Requisitos
Cabeçalho: msdbg.h
Espaço para nome: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll
Comentários
Antes de enviar o evento, o DE verifica se esse evento de exceção foi designado uma exceção de primeira ou segunda chance por uma chamada anterior para SetException. Se tiver sido designado para ser uma exceção de primeira oportunidade, o evento é enviado para o IDebugExceptionEvent2 SDM. Caso contrário, o DE dá ao aplicativo a chance de lidar com a exceção. Se nenhum manipulador de exceção for fornecido e se a exceção tiver sido designada como uma exceção de segunda chance, o IDebugExceptionEvent2 evento será enviado ao SDM. Caso contrário, o DE retoma a execução do programa e o sistema operacional ou tempo de execução manipula a exceção.