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

  • Статья

Метод GetNumberEvents возвращает количество событий для текущего целевого объекта, если число событий фиксированное.

Синтаксис

HRESULT GetNumberEvents(
  [out] PULONG Events
);

Параметры

[out] Events

Получает количество событий, хранящихся в целевом объекте. Если целевой объект предлагает несколько событий, для параметра События будет задано количество доступных событий. В противном случае для события будет задано значение 1.

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

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

Код возврата Описание
S_OK
 Метод был успешным, и Events содержит общее количество событий, возможных для целевого объекта.
S_FALSE
 Метод был успешным, но events содержит только общее количество событий, возможное на текущий момент времени. Целевые объекты, поддерживающие выполнение переменных, могут иметь разные наборы событий, доступные в разных точках выполнения целевого объекта.

Комментарии

Файлы аварийных дампов содержат статический список событий; каждое событие представляет собой snapshot целевого объекта в определенный момент времени. Если текущим целевым объектом является файл аварийного дампа, этот метод устанавливает для events количество хранимых событий и возвращает S_OK.

Динамические целевые объекты создают события динамически и не обязательно имеют известный набор событий. Если текущий целевой объект является динамическим целевым объектом с неограниченным числом событий, этот метод устанавливает для events количество доступных событий и возвращает S_FALSE.

Дополнительные сведения см. в разделе Сведения о событиях.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

GetCurrentEventIndex

IDebugControl3

SetNextEventIndex