IDebugEngine2
Cette interface représente un moteur de débogage (DE). Il est utilisé pour gérer différents aspects d’une session de débogage, de la création de points d’arrêt à la définition et à l’effacement des exceptions.
Syntaxe
IDebugEngine2 : IUnknown
Remarques pour les implémenteurs
Cette interface est implémentée par un DE personnalisé pour gérer le débogage des programmes. Cette interface doit être implémentée par le DE.
Remarques pour les appelants
Cette interface est appelée par le gestionnaire de débogage de session (SDM) pour gérer la session de débogage, notamment la gestion des exceptions, la création de points d’arrêt et la réponse à des événements synchrones envoyés par le DE.
Méthodes dans l'ordre Vtable
Le tableau suivant présente les méthodes de IDebugEngine2.
| Méthode | Description |
|---|---|
| EnumPrograms | Crée un énumérateur pour tous les programmes débogués par un DE. |
| Attacher | Attache un DE à un programme. |
| CreatePendingBreakpoint | Crée un point d’arrêt en attente dans le DE. |
| SetException | Spécifie la façon dont le DE doit gérer une exception donnée. |
| RemoveSetException | Supprime l’exception spécifiée afin qu’elle ne soit plus gérée par le moteur de débogage. |
| RemoveAllSetExceptions | Supprime la liste des exceptions que l’IDE a définies pour une architecture ou une langue d’exécution particulière. |
| GetEngineID | Obtient le GUID du DE. |
| DestroyProgram | Informe un DE que le programme spécifié a été interrompu de manière atypique et que le DE doit propre toutes les références au programme et envoyer un événement de destruction de programme. |
| ContinueFromSynchronousEvent | Appelé par le SDM pour indiquer qu’un événement de débogage synchrone, précédemment envoyé par le DE au SDM, a été reçu et traité. |
| SetLocale | Définit les paramètres régionaux de l’instance DE. |
| SetRegistryRoot | Définit la racine du Registre actuellement utilisée par le DE. |
| SetMetric | Définit une métrique. |
| CauseBreak | Demande que tous les programmes en cours de débogage par ce descripteurs arrêtent l’exécution la prochaine fois qu’un de leurs threads tente d’s’exécuter. |
Spécifications
En-tête : Msdbg.h
Espace de noms : Microsoft.VisualStudio.Debugger.Interop
Assembly : Microsoft.VisualStudio.Debugger.Interop.dll