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