IDebugBreakpoint2：：GetCurrentPassCount 方法 (dbgeng.h)

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

语法

HRESULT GetCurrentPassCount(
  [out] PULONG Count
);

参数

[out] Count

目标在触发断点之前必须命中断点的剩余次数。 目标必须传递断点 而不 触发断点的次数是返回到 Count 的值减 1。

返回值

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

注解

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

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

如果调试器在单步执行代码时在断点位置执行代码，则此执行不会影响触发断点之前剩余的次数。

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

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

要求