SetPassCount

The SetPassCount method sets the number of times that the target must reach the breakpoint location before the breakpoint is triggered.

HRESULT
  IDebugBreakpoint::SetPassCount(
    IN ULONG  Count
    );

Parameters

Count

The number of times that the target must hit the breakpoint before it is triggered. The number of times the target must pass the breakpoint without triggering it is the value of Count, minus one.

Return Value

SetPassCount might return one of the following values:

S_OK

The method was successful.

This method might also return error values. For more information about possible return values, see Return Values.

Comments

Every time that the SetPassCount method is called, the number of times that the target must reach the breakpoint location before the breakpoint is triggered is reset.

After the target has hit the breakpoint enough times to trigger the breakpoint, the breakpoint is triggered every time that it is hit, unless SetPassCount is called again.

If the debugger executes the code at the breakpoint location while stepping through the code, this execution does not contribute to the number of times that remain before the breakpoint is triggered.

For more information about breakpoint properties, see Controlling Breakpoint Flags and Parameters.

Requirements

Versions: Available in all versions of IDebugBreakpoint.

Headers: Defined in Dbgeng.h. Include Dbgeng.h.