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
接收下一個事件的索引。 如果 NextIndex 為 NULL,則不會傳回這項資訊。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值 。
傳回碼 | 描述 |
---|---|
|
此方法成功。 |
備註
如果指定的事件與目前事件相同,則這個方法不會執行任何動作。 否則,此方法會將目標的執行狀態設定為DEBUG_STATUS_GO (,並通知事件回呼) 。 呼叫 WaitForEvent 時,引擎會產生事件回呼的指定事件,並將其設定為目前的事件。
只有在目標提供事件清單時,這個方法才有用。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dbgeng.h (包含 Dbgeng.h) |