IDebugCanStopEvent2
Diese Schnittstelle wird verwendet, um den Sitzungsdebug-Manager (SDM) zu fragen, ob an dem aktuellen Codespeicherort beendet werden soll.
Syntax
IDebugCanStopEvent2 : IUknown
Hinweise für Implementierer
Das Debugmodul (DE) implementiert diese Schnittstelle, um das Schrittweise durchlaufen von Quellcode zu unterstützen. Die IDebugEvent2-Schnittstelle muss auf demselben Objekt wie diese Schnittstelle implementiert werden (das SDM verwendet QueryInterface für den Zugriff auf die IDebugEvent2 Schnittstelle).
Die Implementierung dieser Schnittstelle muss den SDM-Aufruf von CanStop mit dem Debugmodul kommunizieren. Dies kann z. B. mit einer Nachricht erfolgen, die im Nachrichtenbehandlungsthread des Debugmoduls veröffentlicht wurde, oder das Objekt, das diese Schnittstelle implementiert, einen Verweis auf das Debugmodul enthalten und den Rückruf an das Debugmodul mit der an die Datei übergebenen IDebugCanStopEvent2::CanStopKennzeichnung durchführen.
Hinweise für Aufrufer
Die DE kann diese Methode jedes Mal senden, wenn die DE aufgefordert wird, die Ausführung fortzusetzen, und der DE-Code wird schrittweise durchlaufen. Dieses Ereignis wird mithilfe der vom SDM bereitgestellten IDebugEventCallback2-Rückruffunktion gesendet, wenn es an das zu debuggende Programm angefügt wurde.
Methoden in Vtable-Reihenfolge
In der folgenden Tabelle sind die Methoden von IDebugCanStopEvent2 aufgeführt.
| Methode | Beschreibung |
|---|---|
| GetReason | Ruft den Grund für dieses Ereignis ab. |
| CanStop | Gibt an, ob das zu debuggende Programm an der Position dieses Ereignisses beendet werden soll (und ein Ereignis sendet, das den Grund für das Beenden beschreibt) oder einfach die Ausführung fortsetzen soll. |
| GetDocumentContext | Ruft den Dokumentkontext ab, der den Speicherort dieses Ereignisses beschreibt. |
| GetCodeContext | Ruft den Codekontext ab, der den Speicherort dieses Ereignisses beschreibt. |
Hinweise
Die DE sendet diese Schnittstelle, wenn der Benutzer in eine Funktion wechselt und die DE keine Debuginformationen findet oder Debuginformationen vorhanden sind, aber die DE weiß nicht, ob der Quellcode für diesen Speicherort angezeigt werden kann.
Anforderungen
Header: msdbg.h
Namespace: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll