IDebugControl2::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されておらず、別のブレークポイントで DesiredId ID が既に使用されている場合、これらのメソッドは失敗します。

ブレークポイントは空で作成され、無効になります。ブレークポイントの構成と有効化の詳細については、「ブレークポイントの使用」を参照してください。

クライアントは、新しいブレークポイントの加算器として保存されます。 GetAdder 参照してください。

メモ IDebugBreakpoint IUnknown COM インターフェイスを拡張しても、ブレークポイントの有効期間は IUnknown インターフェイスを使用して制御されません。代わりに、RemoveBreakpoint が呼び出後にブレークポイントが削除されます。

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h を含む)