Share via

DkmPendingBreakpoint.SetHitCountCondition Method

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.Breakpoints
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Package:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Initialize, update or clear the hit count condition on all bound breakpoints of this pending breakpoint. If the same breakpoint has both a language-level condition, and a hit count condition, the language-level condition is applied first.

Note that the hit count condition acts independently on each bound breakpoint, rather than being aggregated together on the pending breakpoint. For example, if the hit count is configured to stop at hit #2, and the breakpoint to two separate locations, each of which hit the breakpoint once, the UI will still not have gone into break mode because neither individual bound breakpoint has hit twice.

This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.

Location constraint: API must be called from an IDE component (component level > 100,000).

public:
 void SetHitCountCondition(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, Microsoft::VisualStudio::Debugger::Breakpoints::DkmBreakpointHitCountCondition ^ Condition, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Breakpoints::DkmSetPendingBreakpointHitCountConditionAsyncResult> ^ CompletionRoutine);
public void SetHitCountCondition (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointHitCountCondition Condition, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmSetPendingBreakpointHitCountConditionAsyncResult> CompletionRoutine);
public void SetHitCountCondition (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointHitCountCondition? Condition, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmSetPendingBreakpointHitCountConditionAsyncResult> CompletionRoutine);
member this.SetHitCountCondition : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointHitCountCondition * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmSetPendingBreakpointHitCountConditionAsyncResult> -> unit
Public Sub SetHitCountCondition (WorkList As DkmWorkList, Condition As DkmBreakpointHitCountCondition, CompletionRoutine As DkmCompletionRoutine(Of DkmSetPendingBreakpointHitCountConditionAsyncResult))

Parameters

WorkList
DkmWorkList

WorkList to append the new work item to.

Condition
DkmBreakpointHitCountCondition

[In,Optional] Condition to apply to this breakpoint. This value may be 'null' if the caller wishes to remove the condition.

CompletionRoutine
DkmCompletionRoutine<DkmSetPendingBreakpointHitCountConditionAsyncResult>

Routine to fire when the request is complete. If the request is successfully appended to the work list, this will always fire (including when the operation is canceled). This will never fire if appending the work item fails.

Applies to