IDebugCanStopEvent2

此接口用于询问会话调试管理器(SDM)是否在当前代码位置停止。

语法

IDebugCanStopEvent2 : IUknown

实现者须知

调试引擎 (DE) 实现此接口以支持单步执行源代码。 IDebugEvent2 接口必须在与此接口相同的对象上实现(SDM 使用 QueryInterface 访问IDebugEvent2接口)。

此接口的实现必须将 SDM 对 CanStop 的调用传达给调试引擎。 例如,这可以通过发布到调试引擎的消息处理线程来完成,或者实现此接口的对象可以保存对调试引擎的引用,并使用传入的 IDebugCanStopEvent2::CanStop标志回调调试引擎。

对调用者的说明

DE 每次要求 DE 继续执行时,DE 都可以发送此方法,DE 正在单步执行代码。 当 SDM 附加到正在调试的程序时,使用 SDM 提供的 IDebugEventCallback2 回调函数发送此事件。

Vtable 顺序中的方法

下表显示了 IDebugCanStopEvent2 方法。

方法 说明
GetReason 获取此事件的原因。
CanStop 指定正在调试的程序应停止在此事件的位置(并发送描述停止原因的事件)还是只是继续执行。
GetDocumentContext 获取描述此事件位置的文档上下文。
GetCodeContext 获取描述此事件位置的代码上下文。

备注

如果用户单步执行函数,DE 将发送此接口,并且 DE 找不到任何调试信息或存在调试信息,但 DE 不知道是否可以显示该位置的源代码。

要求

标头:msdbg.h

命名空间:Microsoft.VisualStudio.Debugger.Interop

程序集:Microsoft.VisualStudio.Debugger.Interop.dll

另请参阅