Partager via


IDebugExceptionEvent2

Le moteur de débogage (DE) envoie cette interface au gestionnaire de débogage de session (SDM) lorsqu’une exception est levée dans le programme en cours d’exécution.

Syntaxe

IDebugExceptionEvent2 : IUnknown

Remarques pour les implémenteurs

Le DE implémente cette interface pour signaler qu’une exception s’est produite dans le programme en cours de débogage. L’interface IDebugEvent2 doit être implémentée sur le même objet que cette interface. Le SDM utilise QueryInterface pour accéder à l’interface IDebugEvent2 .

Remarques pour les appelants

Le DE crée et envoie cet objet d’événement pour signaler une exception. L’événement est envoyé à l’aide de la fonction de rappel IDebugEventCallback2 fournie par le SDM lorsqu’il est attaché au programme en cours de débogage.

Méthodes dans l'ordre Vtable

Le tableau suivant présente les méthodes de IDebugExceptionEvent2.

Méthode Description
GetException Obtient des informations détaillées sur l’exception qui a déclenché cet événement.
GetExceptionDescription Obtient une description lisible par l’homme pour l’exception levée qui a déclenché cet événement.
CanPassToDebuggee Détermine si le moteur de débogage (DE) prend en charge l’option de passage de cette exception au programme en cours de débogage lors de la reprise de l’exécution.
PassToDebuggee Spécifie si l’exception doit être transmise au programme en cours de débogage lorsque l’exécution reprend, ou si l’exception doit être dis carte ed.

Spécifications

En-tête : msdbg.h

Espace de noms : Microsoft.VisualStudio.Debugger.Interop

Assembly : Microsoft.VisualStudio.Debugger.Interop.dll

Notes

Avant d’envoyer l’événement, le de case activée s pour voir si cet événement d’exception a été désigné comme une exception de première chance ou de deuxième chance par un appel précédent à SetException. S’il a été désigné comme une exception de première chance, l’événement IDebugExceptionEvent2 est envoyé au SDM. Si ce n’est pas le cas, le DE donne à l’application la possibilité de gérer l’exception. Si aucun gestionnaire d’exceptions n’est fourni et si l’exception a été désignée comme exception de deuxième chance, l’événement IDebugExceptionEvent2 est envoyé au SDM. Sinon, le DE reprend l’exécution du programme, et le système d’exploitation ou le runtime gère l’exception.

Voir aussi