IDebugMessageEvent2
Cette interface est utilisée par le moteur de débogage (DE) pour envoyer un message à Visual Studio qui nécessite une réponse de l’utilisateur.
Syntaxe
IDebugMessageEvent2 : IUnknown
Remarques pour les implémenteurs
Le DE implémente cette interface pour envoyer un message à Visual Studio qui nécessite une réponse utilisateur. 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 .
L’implémentation de cette interface doit communiquer l’appel de Visual Studio de SetResponse à l’instance DE. Par exemple, cela peut être effectué avec un message publié dans le thread de gestion des messages de DE, ou l’objet implémentant cette interface peut contenir une référence au DE et rappeler le DE avec la réponse passée IDebugMessageEvent2::SetResponse.
Remarques pour les appelants
Le DE crée et envoie cet objet d’événement pour afficher un message à l’utilisateur qui nécessite une réponse. L’événement est envoyé à l’aide de la fonction de rappel IDebugEventCallback2 fournie par le SDM lorsqu’elle est attachée au programme en cours de débogage.
Méthodes dans l'ordre Vtable
Le tableau suivant présente les méthodes de IDebugMessageEvent2.
| Méthode | Description |
|---|---|
| GetMessage | Obtient le message à afficher. |
| SetResponse | Définit la réponse, le cas échéant, à partir de la boîte de message. |
Notes
Le DE utilise cette interface s’il nécessite une réponse spécifique de l’utilisateur pour un message particulier. Par exemple, si le DE obtient un message « Accès refusé » après une tentative d’attachement à distance à un programme, le DE envoie ce message particulier à Visual Studio dans un IDebugMessageEvent2 événement avec le style MB_RETRYCANCELde zone de message. Cela permet à l’utilisateur de réessayer ou d’annuler l’opération d’attachement.
Le DE spécifie comment ce message doit être géré en suivant les conventions de la fonction MessageBox Win32 (voir AfxMessageBox pour plus d’informations).
Utilisez l’interface IDebugErrorEvent2 pour envoyer des messages à Visual Studio qui ne nécessitent pas de réponse de l’utilisateur.
Spécifications
En-tête : msdbg.h
Espace de noms : Microsoft.VisualStudio.Debugger.Interop
Assembly : Microsoft.VisualStudio.Debugger.Interop.dll