IDebugExceptionEvent2

Artigo
05/17/2015

O mecanismo de depuração (DE) envia esta interface para o Gerenciador de sessão de depuração (SDM) quando uma exceção é lançada no programa que está sendo executado no momento.

IDebugExceptionEvent2 : IUnknown

Observações para Implementadores

O DE implementa essa interface para o relatório que ocorreu uma exceção no programa que está sendo depurado. O IDebugEvent2 interface deve ser implementada no mesmo objeto dessa interface. O SDM usa QueryInterface para acesso a IDebugEvent2 interface.

Observações para chamadores

O DE cria e envia este objeto de evento para relatar uma exceção. O evento é enviado usando o IDebugEventCallback2 função de retorno de chamada que é fornecida pelo SDM quando anexado ao programa que está sendo depurado.

Métodos na ordem de Vtable

A tabela a seguir mostra os métodos de IDebugExceptionEvent2.

Método	Descrição
IDebugExceptionEvent2::GetException	Deixa as informações detalhadas sobre a exceção que disparou este evento.
IDebugExceptionEvent2::GetExceptionDescription	Obtém uma descrição legível para a exceção lançada que disparou este evento.
IDebugExceptionEvent2::CanPassToDebuggee	Determina se ou não o mecanismo de depuração (DE) oferece suporte para a opção de passar essa exceção para o programa que está sendo depurado voltar a execução.
IDebugExceptionEvent2::PassToDebuggee	Especifica se a exceção deve ser passada para o programa que está sendo depurado voltar a execução, ou se a exceção deve ser descartada.

Requisitos

Cabeçalho: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Comentários

Antes de enviar o evento, DE verifica se esse evento de exceção foi designado uma exceção de primeira chance ou segunda chance por uma chamada anterior a IDebugEngine2::SetException. Se ele tiver sido designado para ser uma exceção de primeira chance, o IDebugExceptionEvent2 evento é enviado para o SDM. Caso contrário, o DE dá ao aplicativo a oportunidade de tratar a exceção. Se nenhum manipulador de exceção for fornecido, e se a exceção foi designada como uma exceção de segunda chance, o IDebugExceptionEvent2 evento é enviado para o SDM. Caso contrário, o DE continua a execução do programa e o sistema operacional ou o tempo de execução lida com a exceção.