IDebugControl3::GetNumberEvents メソッド (dbgeng.h)

GetNumberEvents メソッドは、イベントの数が固定されている場合に、現在のターゲットのイベントの数を返します。

構文

HRESULT GetNumberEvents(
  [out] PULONG Events
);

[out] Events

ターゲットに格納されているイベントの数を受信します。ターゲットが複数のイベントを提供する場合、 イベント は使用可能なイベントの数に設定されます。それ以外の場合、 イベント は 1 に設定されます。

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

リターンコード	説明
S_OK	メソッドは成功し、 Events にはターゲットに対して可能なイベントの合計数が含まれています。
S_FALSE	メソッドは成功しましたが、 Events には現在使用可能なイベントの合計数のみが含まれています。変数の実行をサポートするターゲットでは、ターゲットの実行中に異なるポイントで使用できるイベントのセットが異なる場合があります。

クラッシュダンプファイルには、イベントの静的リストが含まれています。各イベントは、特定の時点でのターゲットのスナップショットを表します。現在のターゲットがクラッシュダンプファイルの場合、このメソッドは Events を格納されているイベントの数に設定し、S_OKを返します。

ライブターゲットはイベントを動的に生成し、必ずしも既知のイベントセットを持つわけではありません。現在のターゲットが制約のないイベント数のライブターゲットである場合、このメソッドは Events を現在使用可能なイベントの数に設定し、S_FALSEを返します。

詳細については、トピック「イベント情報」を参照してください。

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (Dbgeng.h を含む)