Метод IDebugControl3::GetNumberEvents (dbgeng.h)
Метод GetNumberEvents возвращает количество событий для текущего целевого объекта, если число событий фиксированное.
Синтаксис
HRESULT GetNumberEvents(
[out] PULONG Events
);
Параметры
[out] Events
Получает количество событий, хранящихся в целевом объекте. Если целевой объект предлагает несколько событий, для параметра События будет задано количество доступных событий. В противном случае для события будет задано значение 1.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
| Код возврата | Описание |
|---|---|
|
Метод был успешным, и Events содержит общее количество событий, возможных для целевого объекта. |
|
Метод был успешным, но events содержит только общее количество событий, возможное на текущий момент времени. Целевые объекты, поддерживающие выполнение переменных, могут иметь разные наборы событий, доступные в разных точках выполнения целевого объекта. |
Комментарии
Файлы аварийных дампов содержат статический список событий; каждое событие представляет собой snapshot целевого объекта в определенный момент времени. Если текущим целевым объектом является файл аварийного дампа, этот метод устанавливает для events количество хранимых событий и возвращает S_OK.
Динамические целевые объекты создают события динамически и не обязательно имеют известный набор событий. Если текущий целевой объект является динамическим целевым объектом с неограниченным числом событий, этот метод устанавливает для events количество доступных событий и возвращает S_FALSE.
Дополнительные сведения см. в разделе Сведения о событиях.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | dbgeng.h (включая Dbgeng.h) |