Метод IDebugControl3::SetNextEventIndex (dbgeng.h)

Статья
08/07/2023

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

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

Значение отношения	Следующий индекс событий
DEBUG_EINDEX_FROM_START	Значение.
DEBUG_EINDEX_FROM_END	Число событий минус Значение.
DEBUG_EINDEX_FROM_CURRENT	Текущий индекс события плюс значение.

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

[out] NextIndex

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

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

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