IDebugPendingBreakpoint2

Applies to: yesVisual Studio noVisual 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.

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

See also