IDebugControl::AddBreakpoint 方法 (dbgeng.h)

AddBreakpoint 方法为当前目标创建新的断点。

语法

HRESULT AddBreakpoint(
  [in]  ULONG             Type,
  [in]  ULONG             DesiredId,
  [out] PDEBUG_BREAKPOINT *Bp
);

参数

[in] Type

指定新断点的断点类型。 这可以是以下值之一:

价值 描述
DEBUG_BREAKPOINT_CODE 软件断点
DEBUG_BREAKPOINT_DATA 处理器断点

[in] DesiredId

指定新断点的所需 ID。 如果DEBUG_ANY_ID,引擎将选取未使用的 ID。

[out] Bp

接收指向新断点的接口指针。

返回值

返回代码 描述
S_OK
该方法成功。
E_INVALIDARG
无法使用所需的 ID 或无法识别 类型 的值来创建断点。
 

此方法还可以返回其他错误值。 有关详细信息,请参阅 返回值

言论

如果 DesiredId 未DEBUG_ANY_ID,另一个断点已使用 ID DesiredId,则这些方法将失败。

断点为空并禁用。 有关配置和启用断点的详细信息,请参阅 使用断点

客户端将保存为新断点的添加器。 请参阅 GetAdder

注释 即使 IDebugBreakpoint 扩展 COM 接口 IUnknown,断点的生存期不受 IUnknown 接口的控制。 而是在调用 removeBreakpoint 后删除断点。
 

要求

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

另请参阅

断点

IDebugBreakpoint

IDebugControl

IDebugControl2

IDebugControl3

RemoveBreakpoint

使用断点