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

SetNextEventIndex メソッドは、ターゲットのイベントの静的リストからイベントを選択することによって、現在のターゲットの次のイベントを設定します (そのようなリストが存在する場合)。

構文

HRESULT SetNextEventIndex(
  [in]  ULONG  Relation,
  [in]  ULONG  Value,
  [out] PULONG NextIndex
);

パラメーター

[in] Relation

次のイベントのインデックスを設定するときに Value を解釈する方法を指定します。 使用可能な値は、DEBUG_EINDEX_FROM_START、DEBUG_EINDEX_FROM_END、およびDEBUG_EINDEX_FROM_CURRENTです。

[in] Value

最初のイベント、最後のイベント、または現在のイベントを基準とした次のイベントのインデックスを指定します。 値 の解釈は、次のように 関係の値によって異なります。

関係 の値	次のイベント インデックス
DEBUG_EINDEX_FROM_START	値の。
DEBUG_EINDEX_FROM_END	イベントの数から Valueを引いた値。
DEBUG_EINDEX_FROM_CURRENT	現在のイベント インデックスと Value。

 

結果のインデックスは、0 より大きく、GetNumberEventsによって返されるイベントの数より 1 未満である必要があります。

[out] NextIndex

次のイベントのインデックスを受け取ります。 NextIndex が NULL 場合、この情報は返されません。

戻り値

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

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

備考

指定したイベントが現在のイベントと同じ場合、このメソッドは何も行いません。 それ以外の場合、このメソッドはターゲットの実行状態をDEBUG_STATUS_GOに設定します (イベント コールバックを通知します)。 WaitForEvent 呼び出されると、エンジンはイベント コールバックに対して指定されたイベントを生成し、それを現在のイベントとして設定します。

このメソッドは、ターゲットがイベントの一覧を提供する場合にのみ役立ちます。

必要条件

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

関連項目

GetCurrentEventIndex の

GetNumberEvents の

IDebugControl3 の