IDebugPendingBreakpoint2

This interface represents a breakpoint that is ready to bind to a code location.

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 IDebugEngine2::CreatePendingBreakpoint creates a pending breakpoint from an IDebugBreakpointRequest2 interface. A call to IDebugPendingBreakpoint2::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
IDebugPendingBreakpoint2::CanBind	Determines whether this pending breakpoint can bind to a code location.
IDebugPendingBreakpoint2::Bind	Binds this pending breakpoint to one or more code locations.
IDebugPendingBreakpoint2::GetState	Gets the state of this pending breakpoint.
IDebugPendingBreakpoint2::GetBreakpointRequest	Gets the breakpoint request that was used to create this pending breakpoint.
IDebugPendingBreakpoint2::Virtualize	Toggles the virtualized state of this pending breakpoint.
IDebugPendingBreakpoint2::Enable	Toggles the enabled state of this pending breakpoint.
IDebugPendingBreakpoint2::SetCondition	Sets or changes the condition associated with this pending breakpoint.
IDebugPendingBreakpoint2::SetPassCount	Sets or changes the pass count associated with this pending breakpoint.
IDebugPendingBreakpoint2::EnumBoundBreakpoints	Enumerates all breakpoints bound from this pending breakpoint.
IDebugPendingBreakpoint2::EnumErrorBreakpoints	Enumerates all error breakpoints that resulted from this pending breakpoint.
IDebugPendingBreakpoint2::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

Reference

IDebugEngine2::CreatePendingBreakpoint

IDebugBreakpointBoundEvent2::GetPendingBreakpoint

IDebugBoundBreakpoint2::GetPendingBreakpoint

IDebugErrorBreakpoint2::GetPendingBreakpoint