IDebugExceptionEvent2IDebugExceptionEvent2

Le moteur de débogage (DE) envoie cette interface pour le Gestionnaire de session de débogage (SDM) lorsqu’une exception est levée dans le programme en cours d’exécution.The debug engine (DE) sends this interface to the session debug manager (SDM) when an exception is thrown in the program currently being executed.

SyntaxeSyntax

IDebugExceptionEvent2 : IUnknown  

Notes pour les implémenteursNotes for Implementers

Le D’implémente cette interface pour les rapports qu’une exception s’est produite dans le programme en cours de débogage.The DE implements this interface to report that an exception has occurred in the program being debugged. Le IDebugEvent2 interface doit être implémentée sur le même objet que cette interface.The IDebugEvent2 interface must be implemented on the same object as this interface. Le SDM utilise QueryInterface pour accéder à la IDebugEvent2 interface.The SDM uses QueryInterface to access the IDebugEvent2 interface.

Remarques pour les appelantsNotes for Callers

Le crée et envoie cet objet d’événement pour signaler une exception.The DE creates and sends this event object to report an exception. L’événement est envoyé à l’aide de la IDebugEventCallback2 fonction de rappel qui est fournie par le SDM lorsqu’il est attaché au programme en cours de débogage.The event is sent using the IDebugEventCallback2 callback function that is supplied by the SDM when it attached to the program being debugged.

Méthodes dans l'ordre VtableMethods in Vtable Order

Le tableau suivant présente les méthodes de IDebugExceptionEvent2.The following table shows the methods of IDebugExceptionEvent2.

MéthodeMethod DescriptionDescription
GetExceptionGetException Obtient des informations détaillées sur l’exception qui a déclenché cet événement.Gets detailed information about the exception that fired this event.
GetExceptionDescriptionGetExceptionDescription Obtient une description explicite de l’exception levée qui a déclenché cet événement.Gets a human-readable description for the exception thrown that fired this event.
CanPassToDebuggeeCanPassToDebuggee Détermine si le moteur de débogage (DE) prend en charge les transmettre cette exception au programme en cours de débogage lors de l’exécution se poursuit.Determines whether or not the debug engine (DE) supports the option of passing this exception to the program being debugged when execution resumes.
PassToDebuggeePassToDebuggee Spécifie si l’exception doit être transmise au programme en cours de débogage lors de l’exécution se poursuit, ou si l’exception doit être ignorée.Specifies whether the exception should be passed on to the program being debugged when execution resumes, or if the exception should be discarded.

SpécificationsRequirements

En-tête : msdbg.hHeader: msdbg.h

Namespace : Microsoft.VisualStudio.Debugger.InteropNamespace: Microsoft.VisualStudio.Debugger.Interop

Assembly : Microsoft.VisualStudio.Debugger.Interop.dllAssembly: Microsoft.VisualStudio.Debugger.Interop.dll

NotesRemarks

Avant d’envoyer l’événement, le DE vérifie si cet événement d’exception a été désigné une exception de première chance ou de deuxième chance par un appel précédent à SetException.Before sending the event, the DE checks to see if this exception event has been designated a first-chance or second-chance exception by a previous call to SetException. S’il a été désigné pour être une exception de première chance, les IDebugExceptionEvent2 événement est envoyé à la SDM.If it has been designated to be a first-chance exception, the IDebugExceptionEvent2 event is sent to the SDM. Si ce n’est pas le cas, le DE donne une occasion de gérer l’exception à l’application.If not, the DE gives the application a chance to handle the exception. Si aucun gestionnaire d’exceptions n’est fourni, et si l’exception a été désignée comme une exception de deuxième chance, les IDebugExceptionEvent2 événement est envoyé à la SDM.If no exception handler is provided, and if the exception has been designated as a second-chance exception, the IDebugExceptionEvent2 event is sent to the SDM. Dans le cas contraire, le DE reprend l’exécution du programme, et le système d’exploitation ou le runtime gère l’exception.Otherwise, the DE resumes execution of the program, and the operating system or runtime handles the exception.

Voir aussiSee Also

Interfaces de base Core Interfaces
SetException SetException
IDebugEvent2 IDebugEvent2
IDebugEventCallback2IDebugEventCallback2