IDebugBreakpoint2::GetPassCount メソッド (dbgeng.h)

GetPassCount メソッドは、ブレークポイントがトリガーされるまでに、最初にターゲットがブレークポイントの場所に到達するために必要だった回数を返します。

構文

HRESULT GetPassCount(
  [out] PULONG Count
);

パラメーター

[out] Count

トリガーされるまでに、ターゲットが最初にブレークポイントにヒットする必要があった回数。 ターゲットが最初にブレークポイントをトリガーせずにブレークポイントを渡すために必要だった回数は、Countに返される値から 1 を引いた値です。

戻り値

リターン コード	形容
S_OK	メソッドが成功しました。

 

このメソッドは、エラー値を返すこともできます。 詳細については、「戻り値 を参照してください。

備考

GetPassCount メソッドは、ブレークポイントをトリガーするために最初に必要だったヒット数を返します。 GetCurrentPassCount メソッドは、ブレークポイントをトリガーするために引き続き発生する必要があるヒット数を返します。 たとえば、ブレークポイントがパスカウント 20 で作成され、これまでに 5 回のパスがあった場合、このメソッドは GetPassCount 20 を返し、GetCurrentPassCount 15 を返。

ターゲットがブレークポイントをトリガーするのに十分な時間が経過すると、SetPassCount を呼び出さない限り、ヒットするたびにブレークポイントトリガーされます。 SetPassCount 呼び出して、ブレークポイントがトリガーされる前にパス数を変更することもできます。 この呼び出しは、元のパス数と残りのパス数をリセットします。

コードのステップ実行中にデバッガーがブレークポイントの場所でコードを実行した場合、この実行はブレークポイントがトリガーされるまでの残りの回数には影響しません。

GetParameters メソッドは、Countで返される情報も返します。

ブレークポイントのプロパティの詳細については、「ブレークポイント フラグとパラメーターの制御 を参照してください。

必要条件

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