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 | 事件数减去 值。 |
| DEBUG_EINDEX_FROM_CURRENT | 当前事件索引加上 值。 |
生成的索引必须大于零，比 GetNumberEvents 返回的事件数少一个。
[out] NextIndex
接收下一个事件的索引。 如果 NextIndex 为 NULL，则不会返回此信息。
返回值
此方法也可能返回错误值。 有关更多详细信息 ，请参阅返回值 。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
注解
如果指定的事件与当前事件相同，则此方法不执行任何工作。 否则，此方法将目标的执行状态设置为DEBUG_STATUS_GO (，并通知事件回调) 。 调用 WaitForEvent 时，引擎将为事件回调生成指定的事件，并将其设置为当前事件。
仅当目标提供事件列表时，此方法才有用。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dbgeng.h (包括 Dbgeng.h) |