IDebugControl3::GetNumberEvents 方法 (dbgeng.h)
如果事件数是固定的,GetNumberEvents 方法返回当前目标的事件数。
语法
HRESULT GetNumberEvents(
[out] PULONG Events
);
参数
[out] Events
接收目标中存储的事件数。 如果目标提供多个事件, 事件 将设置为可用事件数。 否则, 事件 将设置为 1。
返回值
此方法也可能返回错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
方法成功, 事件 包含目标可能的事件总数。 |
|
方法成功,但 事件 仅包含当前可能的事件总数。 在目标执行期间,支持变量执行的目标可能在不同的点具有不同的事件集。 |
注解
故障转储文件包含静态事件列表;每个事件表示目标在特定时间点的快照。 如果当前目标是故障转储文件,则此方法将 “事件” 设置为存储的事件数,并返回S_OK。
实时目标动态生成事件,不一定具有一组已知的事件。 如果当前目标是具有不受限制的事件数的实时目标,则此方法将 “事件” 设置为当前可用的事件数,并返回S_FALSE。
有关详细信息,请参阅主题 事件信息。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |