IDebugCanStopEvent2IDebugCanStopEvent2

Cette interface est utilisée pour demander le Gestionnaire de session de débogage (SDM) s’il faut arrêter à l’emplacement du code en cours.This interface is used to ask the session debug manager (SDM) whether to stop at the current code location.

SyntaxeSyntax

IDebugCanStopEvent2 : IUknown  

Notes pour les implémenteursNotes for Implementers

Le moteur de débogage (DE) implémente cette interface pour prendre en charge le pas à pas détaillé dans le code source.The debug engine (DE) implements this interface to support stepping through source code. Le IDebugEvent2 interface doit être implémentée sur le même objet que cette interface (le SDM utilise QueryInterface pour accéder à la IDebugEvent2 interface).The IDebugEvent2 interface must be implemented on the same object as this interface (the SDM uses QueryInterface to access the IDebugEvent2 interface).

L’implémentation de cette interface doit communiquer l’appel de la SDM de CanStop pour le moteur de débogage.The implementation of this interface must communicate the SDM's call of CanStop to the debug engine. Par exemple, cela est possible avec un message publié sur le thread des messages du moteur de débogage ou de l’objet qui implémente cette interface peut contenir une référence au moteur de débogage et rappeler dans le moteur de débogage avec l’indicateur passé dans IDebugCanStopEvent2::CanStop.For example, this can be done with a message posted to the debug engine's message handling thread or the object implementing this interface could hold a reference to the debug engine and call back into the debug engine with the flag passed into IDebugCanStopEvent2::CanStop.

Remarques pour les appelantsNotes for Callers

Le DE peut envoyer cette méthode chaque fois que la D’est invitée à continuer l’exécution et DE est parcours du code.The DE can send this method each time the DE is asked to continue execution and the DE is stepping through code. Cet événement est envoyé à l’aide de la IDebugEventCallback2 fonction de rappel fournie par le SDM lorsqu’il est attaché au programme en cours de débogage.This event is sent by using the IDebugEventCallback2 callback function 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 IDebugCanStopEvent2.The following table shows the methods of IDebugCanStopEvent2.

MéthodeMethod DescriptionDescription
GetReasonGetReason Obtient la raison de cet événement.Gets the reason for this event.
CanStopCanStop Spécifie si le programme en cours de débogage doit s’arrêter à l’emplacement de cet événement (et envoyer un événement qui décrit la raison de l’arrêt) ou simplement de poursuivre l’exécution.Specifies whether the program being debugged should stop at the location of this event (and send an event that describes the reason for stopping) or just continue execution.
GetDocumentContextGetDocumentContext Obtient le contexte de document qui décrit l’emplacement de cet événement.Gets the document context that describes the location of this event.
GetCodeContextGetCodeContext Obtient le contexte de code qui décrit l’emplacement de cet événement.Gets the code context that describes the location of this event.

NotesRemarks

Le D’envoie cette interface si les étapes de l’utilisateur dans une fonction et DE ne recherche aucune information de débogage il ou les informations de débogage existent mais le DE ne sait pas si le code source peut être affiché pour cet emplacement.The DE sends this interface if the user steps into a function and the DE finds no debug information there or debug information exists but the DE does not know if the source code can be displayed for that location.

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

Voir aussiSee Also

IDebugStepCompleteEvent2 IDebugStepCompleteEvent2
IDebugEventCallback2IDebugEventCallback2