IDebugControl3：：AddBreakpoint 方法 (dbgeng.h)

AddBreakpoint 方法會建立目前目標的新斷點。

語法

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

[in] Type

指定新斷點的斷點類型。這可以是下列其中一個值：

值	Description
DEBUG_BREAKPOINT_CODE	軟體斷點
DEBUG_BREAKPOINT_DATA	處理器斷點

[in] DesiredId

指定新斷點所需的識別碼。如果DEBUG_ANY_ID，引擎會挑選未使用的標識符。

[out] Bp

接收新斷點的介面指標。

傳回碼	描述
S_OK	此方法成功。
E_INVALIDARG	無法以所需的標識碼建立斷點，或無法辨識 Type 的值。

這個方法也可能傳回其他錯誤值。如需詳細資訊，請參閱傳回值。

如果 DesiredId 未DEBUG_ANY_ID，而另一個斷點已經使用 ID DesiredId，這些方法將會失敗。

斷點會建立空白並停用。如需設定和啟用斷點的詳細資訊，請參閱使用斷點。

用戶端會儲存為新斷點的新增器。請參閱 GetAdder。

注意即使 IDebugBreakpoint 延伸 COM 介面 IUnknown，但斷點的存留期不會使用 IUnknown 介面來控制。而是在呼叫 RemoveBreakpoint 之後刪除斷點。

需求	值
目標平台	桌面
標頭	dbgeng.h (包含 Dbgeng.h)