IDebugControl3::SetNextEventIndex 方法 (dbgeng.h)

SetNextEventIndex 方法通过从目标的静态事件列表中选择事件来设置当前目标的下一个事件(如果存在此类列表)。

语法

HRESULT SetNextEventIndex(
  [in]  ULONG  Relation,
  [in]  ULONG  Value,
  [out] PULONG NextIndex
);

参数

[in] Relation

指定设置下一个事件的索引时如何解释 。 可能的值包括:DEBUG_EINDEX_FROM_START、DEBUG_EINDEX_FROM_END和DEBUG_EINDEX_FROM_CURRENT。

[in] Value

指定相对于第一个、最后一个或当前事件的下一个事件的索引。 的解释取决于关系的值,如下所示。

关系 下一个事件索引
DEBUG_EINDEX_FROM_START
DEBUG_EINDEX_FROM_END 事件数减去
DEBUG_EINDEX_FROM_CURRENT 当前事件索引加
 

生成的索引必须大于零,且小于 GetNumberEvents 返回的事件数。

[out] NextIndex

接收下一个事件的索引。 如果 NextIndexNULL,则不会返回此信息。

返回值

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

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

注解

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

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

要求

   
目标平台 桌面
Header dbgeng.h (包括 Dbgeng.h)

另请参阅

GetCurrentEventIndex

GetNumberEvents

IDebugControl3