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 创建断点，或者无法识别 Type 的值。

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

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

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

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

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

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