IDebugControl3：：GetNumberEvents 方法 (dbgeng.h)

如果事件数是固定的，GetNumberEvents 方法返回当前目标的事件数。

语法

HRESULT GetNumberEvents(
  [out] PULONG Events
);

[out] Events

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

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

返回代码	说明
S_OK	方法成功，事件包含目标可能的事件总数。
S_FALSE	方法成功，但事件仅包含当前可能的事件总数。在目标执行期间，支持变量执行的目标可能在不同的点具有不同的事件集。

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

实时目标动态生成事件，不一定具有一组已知的事件。如果当前目标是具有不受限制的事件数的实时目标，则此方法将 “事件” 设置为当前可用的事件数，并返回S_FALSE。

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

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