IDebugControl4：：AddBreakpoint2 方法 (dbgeng.h)

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

语法

HRESULT AddBreakpoint2(
  [in]  ULONG              Type,
  [in]  ULONG              DesiredId,
  [out] PDEBUG_BREAKPOINT2 *Bp
);

[in] Type

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

值	说明
DEBUG_BREAKPOINT_CODE	软件断点
DEBUG_BREAKPOINT_DATA	处理器断点

[in] DesiredId

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

[out] Bp

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

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	无法使用所需的 ID 创建断点，或者无法识别 Type 的值。

此方法也可能返回其他错误值。有关更多详细信息，请参阅返回值。

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

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

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

注意即使 IDebugBreakpoint 扩展了 COM 接口 IUnknown，也不使用 IUnknown 接口控制断点的生存期。而是在调用 RemoveBreakpoint 后删除断点。

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