DkmProcess.RemoveExceptionTrigger Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| RemoveExceptionTrigger(DkmWorkList, Guid, DkmExceptionTrigger, DkmCompletionRoutine<DkmRemoveExceptionTriggerAsyncResult>) |
Removes an exception trigger previously set. Note that the processing stage is ignored and does not need to match the value originally provided. 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. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
| RemoveExceptionTrigger(Guid, DkmExceptionTrigger) |
Removes an exception trigger previously set. Note that the processing stage is ignored and does not need to match the value originally provided. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
RemoveExceptionTrigger(DkmWorkList, Guid, DkmExceptionTrigger, DkmCompletionRoutine<DkmRemoveExceptionTriggerAsyncResult>)
Removes an exception trigger previously set. Note that the processing stage is ignored and does not need to match the value originally provided.
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.
This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
public:
void RemoveExceptionTrigger(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, Guid SourceId, Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionTrigger ^ Trigger, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Exceptions::DkmRemoveExceptionTriggerAsyncResult> ^ CompletionRoutine);public void RemoveExceptionTrigger (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Guid SourceId, Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionTrigger Trigger, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Exceptions.DkmRemoveExceptionTriggerAsyncResult> CompletionRoutine);member this.RemoveExceptionTrigger : Microsoft.VisualStudio.Debugger.DkmWorkList * Guid * Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionTrigger * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Exceptions.DkmRemoveExceptionTriggerAsyncResult> -> unitPublic Sub RemoveExceptionTrigger (WorkList As DkmWorkList, SourceId As Guid, Trigger As DkmExceptionTrigger, CompletionRoutine As DkmCompletionRoutine(Of DkmRemoveExceptionTriggerAsyncResult))Parameters
- WorkList
- DkmWorkList
WorkList to append the new work item to.
- SourceId
- Guid
[In] Identifies the source of an object. SourceIds are used to enable filtering in scenarios when multiple components may be creating instances of a class. For example, source ids can be used to determine if a breakpoint comes from the AD7 AL (ex: user breakpoint, or other breakpoint visible at the SDM level) instead of a breakpoint which may be created by another component (for example an internal breakpoint used for stepping).
- Trigger
- DkmExceptionTrigger
[In] Describes an exception or collection of exceptions which a component wants to break on. When a higher level components wants to be notified about certain exceptions, it should create one or more exception triggers, and then enable these triggers (DkmProcess.EnableExceptionTriggers). After this, when the exception occurs, a ExceptionTriggerHit exception will be fired whenever this trigger is met.
- CompletionRoutine
- DkmCompletionRoutine<DkmRemoveExceptionTriggerAsyncResult>
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
RemoveExceptionTrigger(Guid, DkmExceptionTrigger)
Removes an exception trigger previously set. Note that the processing stage is ignored and does not need to match the value originally provided.
This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
public:
void RemoveExceptionTrigger(Guid SourceId, Microsoft::VisualStudio::Debugger::Exceptions::DkmExceptionTrigger ^ Trigger);public void RemoveExceptionTrigger (Guid SourceId, Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionTrigger Trigger);member this.RemoveExceptionTrigger : Guid * Microsoft.VisualStudio.Debugger.Exceptions.DkmExceptionTrigger -> unitPublic Sub RemoveExceptionTrigger (SourceId As Guid, Trigger As DkmExceptionTrigger)Parameters
- SourceId
- Guid
[In] Identifies the source of an object. SourceIds are used to enable filtering in scenarios when multiple components may be creating instances of a class. For example, source ids can be used to determine if a breakpoint comes from the AD7 AL (ex: user breakpoint, or other breakpoint visible at the SDM level) instead of a breakpoint which may be created by another component (for example an internal breakpoint used for stepping).
- Trigger
- DkmExceptionTrigger
[In] Describes an exception or collection of exceptions which a component wants to break on. When a higher level components wants to be notified about certain exceptions, it should create one or more exception triggers, and then enable these triggers (DkmProcess.EnableExceptionTriggers). After this, when the exception occurs, a ExceptionTriggerHit exception will be fired whenever this trigger is met.