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