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,則不會傳回此資訊。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
言論
如果指定的事件與目前事件相同,則這個方法不會執行任何動作。 否則,這個方法會將目標的執行狀態設定為DEBUG_STATUS_GO(並通知事件回呼)。 呼叫 waitForEvent 時,引擎會產生事件回呼的指定事件,並將其設定為目前事件。
只有當目標提供事件清單時,這個方法才有用。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |