共用方式為


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的值,如下所示。

關聯 的值 下一個事件索引
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 (include Dbgeng.h)

另請參閱

GetCurrentEventIndex

GetNumberEvents

IDebugControl3