IDebugBreakpoint：：GetPassCount 方法 (dbgeng.h)

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

语法

HRESULT GetPassCount(
  [out] PULONG Count
);

参数

[out] Count

目标在触发断点之前最初需要命中断点的次数。 最初要求目标传递断点而不触发断点的次数是返回到 Count 的值减 1。

返回值

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

注解

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

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

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

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

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

要求