IDebugPendingBreakpoint2
Applies to: Visual Studio Visual Studio for Mac
Note
This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
This interface represents a breakpoint that is ready to bind to a code location.
IDebugPendingBreakpoint2 : IUnknown
The debug engine (DE) implements this interface as part of its support for breakpoints.
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.
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. |
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.
Header: msdbg.h
Namespace: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll