IDebugControl3::GetNumberEvents 方法 (dbgeng.h)

GetNumberEvents 方法返回当前目标 事件数(如果已修复事件数)。

语法

HRESULT GetNumberEvents(
  [out] PULONG Events
);

参数

[out] Events

接收目标中存储的事件数。 如果目标提供多个事件,事件 将设置为可用的事件数。 否则,事件 将设置为一个。

返回值

此方法也可能返回错误值。 有关详细信息,请参阅 返回值

返回代码 描述
S_OK
该方法成功,事件 包含目标可能的事件总数。
S_FALSE
该方法成功,但 事件 仅包含当前可能的事件总数。 支持变量执行的目标可能在目标执行期间的不同点提供不同的事件集。

言论

故障转储文件包含静态事件列表;每个事件表示特定时间点的目标快照。 如果当前目标是故障转储文件,此方法将 事件 设置为存储的事件数,并返回S_OK。

实时目标动态生成事件,不一定具有一组已知的事件。 如果当前目标是具有不受约束的事件数的实时目标,此方法将 事件 为当前可用的事件数,并返回S_FALSE。

有关详细信息,请参阅主题 事件信息

要求

要求 价值
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

GetCurrentEventIndex

IDebugControl3

SetNextEventIndex