IDebugEventCallbacks::Breakpoint 方法 (dbgeng.h)

当目标发出断点异常时,引擎将调用 断点 回调方法。

语法

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT Bp
);

参数

[in] Bp

指定指向与触发断点对应的 IDebugBreakpoint 对象的指针。

返回值

此方法返回一个 DEBUG_STATUS_XXX 值,该值指示引擎处理此事件后目标的执行应如何继续。 有关引擎如何处理此值的详细信息,请参阅 监视事件

言论

如果断点具有关联的命令,引擎会在调用此方法之前执行该命令。

仅当引擎中存在与断点对应的 IDebugBreakpoint 对象,并且--如果断点是专用断点,则引擎将仅调用此方法--此 IDebugEventCallbacks 对象已注册到添加断点的客户端。

仅当 IDebugEventCallbacks::GetInterestMask返回的掩码中设置了DEBUG_EVENT_BREAKPOINT标志时,引擎才会调用此方法。

由于引擎在删除断点时删除相应的 IDebugBreakpoint 对象(例如,通过使用 RemoveBreakpoint),因此在 断点 返回后,Bp 的值可能无效。 因此,IDebugEventCallbacks 的实现在 断点 返回后,不应 访问 bp

有关处理事件的详细信息,请参阅 监视事件。 有关管理断点的信息,请参阅 断点

要求

要求 价值
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)