IDebugPendingBreakpoint2

Article
11/15/2016

Note

This article applies to Visual Studio 2015. 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

Share via