Метод 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

Указывает индекс следующего события относительно первого, последнего или текущего события. Интерпретация значения зависит от значения отношения, как показано ниже.

Результирующий индекс должен быть больше нуля и меньше количества событий, возвращаемых GetNumberEvents.

[out] NextIndex

Получает индекс следующего события. Если NextIndexnull, эти сведения не возвращаются.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Замечания

Если указанное событие совпадает с текущим событием, этот метод ничего не делает. В противном случае этот метод задает состояние выполнения целевого объекта для DEBUG_STATUS_GO (и уведомляет обратные вызовы событий). При вызове WaitForEvent подсистема создаст указанное событие для обратных вызовов событий и задайте его в качестве текущего события.

Этот метод полезен только в том случае, если целевой объект предлагает список событий.

Требования

См. также

GetCurrentEventIndex

GetNumberEvents

IDebugControl3