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を返します。

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

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