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

2025-02-06

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

Синтаксис

HRESULT GetNumberEvents(
  [out] PULONG Events
);

Параметры

[out] Events

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

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

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

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

Возвращаемый код

Описание

S_OK

Метод был успешным, и События содержат общее количество событий, возможных для целевого объекта.

S_FALSE

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

Замечания

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

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

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