IDebugPendingBreakpoint2
This interface represents a breakpoint that is ready to bind to a code location.
Syntax
IDebugPendingBreakpoint2 : IUnknown
Notes for Implementers
The debug engine (DE) implements this interface as part of its support for breakpoints.
Notes for Callers
A call to CreatePendingBreakpoint creates a pending breakpoint from an IDebugBreakpointRequest2 interface. A call to Bind creates an IDebugBreakpoint2 interface that represents a bound breakpoint in the program.
Methods in Vtable Order
The following table shows the methods of IDebugPendingBreakpoint2.
| Method | Description |
|---|---|
| CanBind | Determines whether this pending breakpoint can bind to a code location. |
| Bind | Binds this pending breakpoint to one or more code locations. |
| GetState | Gets the state of this pending breakpoint. |
| GetBreakpointRequest | Gets the breakpoint request that was used to create this pending breakpoint. |
| Virtualize | Toggles the virtualized state of this pending breakpoint. |
| Enable | Toggles the enabled state of this pending breakpoint. |
| SetCondition | Sets or changes the condition associated with this pending breakpoint. |
| SetPassCount | Sets or changes the pass count associated with this pending breakpoint. |
| EnumBoundBreakpoints | Enumerates all breakpoints bound from this pending breakpoint. |
| EnumErrorBreakpoints | Enumerates all error breakpoints that resulted from this pending breakpoint. |
| Delete | Deletes this pending breakpoint and all breakpoints bound from it. |
Remarks
IDebugPendingBreakpoint2 can be thought of as a provider of all the necessary information needed to bind a breakpoint to code that can be applied to one or many programs.
A pending breakpoint can potentially produce more than one bound breakpoint. For example, a breakpoint in a C++-style template could produce a bound breakpoint for each unique instance of that template.
Requirements
Header: msdbg.h
Namespace: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll