DkmPendingBreakpoint.SetCondition Method

Definition

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

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 SetCondition(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, Microsoft::VisualStudio::Debugger::Breakpoints::DkmBreakpointCondition ^ Condition, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Breakpoints::DkmSetPendingBreakpointConditionAsyncResult> ^ CompletionRoutine);
public void SetCondition (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointCondition Condition, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmSetPendingBreakpointConditionAsyncResult> CompletionRoutine);
public void SetCondition (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointCondition? Condition, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmSetPendingBreakpointConditionAsyncResult> CompletionRoutine);
member this.SetCondition : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointCondition * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmSetPendingBreakpointConditionAsyncResult> -> unit
Public Sub SetCondition (WorkList As DkmWorkList, Condition As DkmBreakpointCondition, CompletionRoutine As DkmCompletionRoutine(Of DkmSetPendingBreakpointConditionAsyncResult))

Parameters

WorkList
DkmWorkList

WorkList to append the new work item to.

Condition
DkmBreakpointCondition

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

CompletionRoutine
DkmCompletionRoutine<DkmSetPendingBreakpointConditionAsyncResult>

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