IDebugBreakpoint::GetCurrentPassCount 方法 (dbgeng.h)

GetCurrentPassCount 方法返回目标在触发断点之前必须到达断点位置的剩余次数。

语法

HRESULT GetCurrentPassCount(
  [out] PULONG Count
);

参数

[out] Count

目标在触发前必须命中断点的剩余次数。 目标必须传递断点 的次数,而不 触发,即返回 计数的值减一。

返回值

返回代码 描述
S_OK
该方法成功。
 

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

言论

GetPassCount 方法返回触发断点所需的命中数。 GetCurrentPassCount 返回触发断点时仍必须发生的命中数。 例如,如果使用传递计数为 20 创建了断点,并且到目前为止已有 5 次传递,则 GetPassCount 返回 20,GetCurrentPassCount 返回 15。

目标命中断点的时间足够后,每次命中断点时都会触发断点,除非再次调用 setPassCount 。 还可以调用 SetPassCount 以在触发断点之前更改传递计数。 此调用将重置原始传递计数和剩余的传递计数。

如果在单步执行代码时调试器在断点位置执行代码,则此执行不会导致触发断点之前保留的次数。

GetParameters 方法还返回 Count中返回的信息。

有关断点属性的详细信息,请参阅 控制断点标志和参数

要求

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