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.