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，则不会返回此信息。

返回值

此方法也可能返回错误值。 有关更多详细信息 ，请参阅返回值 。

返回代码 说明
S_OK
 方法成功。

注解

如果指定的事件与当前事件相同，则此方法不执行任何工作。 否则，此方法将目标的执行状态设置为DEBUG_STATUS_GO (，并通知事件回调) 。 调用 WaitForEvent 时，引擎将为事件回调生成指定的事件，并将其设置为当前事件。

仅当目标提供事件列表时，此方法才有用。

要求

要求 值
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

GetCurrentEventIndex

GetNumberEvents

IDebugControl3