通过

IDebugBreakpoint2：：GetPassCount 方法 （dbgeng.h）

  • 项目

GetPassCount 方法返回在触发断点之前到达断点位置所需的目标次数。

语法

HRESULT GetPassCount(
  [out] PULONG Count
);

参数

[out] Count

目标最初在触发前命中断点所需的次数。 目标最初需要传递断点而不触发的次数是返回 计数的值，减一。

返回值

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

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

言论

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

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

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

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

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

要求

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