共用方式為


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

指定相對於第一個、最後一個或目前事件之下一個事件的索引。 Value 的解譯取決於 Relation 的值,如下所示。

Relation 的值 下一個事件索引
DEBUG_EINDEX_FROM_START
DEBUG_EINDEX_FROM_END 事件數目減 去 Value
DEBUG_EINDEX_FROM_CURRENT 目前的事件索引加上 Value
 

產生的索引必須大於零,且一個小於 GetNumberEvents 傳回的事件數目。

[out] NextIndex

接收下一個事件的索引。 如果 NextIndexNULL,則不會傳回這項資訊。

傳回值

這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值

傳回碼 描述
S_OK
此方法成功。

備註

如果指定的事件與目前事件相同,則這個方法不會執行任何動作。 否則,此方法會將目標的執行狀態設定為DEBUG_STATUS_GO (,並通知事件回呼) 。 呼叫 WaitForEvent 時,引擎會產生事件回呼的指定事件,並將其設定為目前的事件。

只有在目標提供事件清單時,這個方法才有用。

規格需求

需求
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

GetCurrentEventIndex

GetNumberEvents

IDebugControl3