IDebugBreakpointErrorEvent2

This interface tells the session debug manager (SDM) that a pending breakpoint could not be bound to a loaded program, either because of a warning or an error.

IDebugBreakpointErrorEvent2 : IUnknown

Notes for Implementers

The DE implements this interface as part of its support for breakpoints. The IDebugEvent2 interface must be implemented on the same object as this interface (the SDM uses QueryInterface to access the IDebugEvent2 interface).

Notes for Callers

The DE creates and sends this event object when a pending breakpoint cannot be bound to the program being debugged. The event is sent by using the IDebugEventCallback2 callback function supplied by the SDM when it attached to the program being debugged.

Methods in Vtable Order

The following table shows the methods of IDebugBreakpointErrorEvent2.

Method

Description

IDebugBreakpointErrorEvent2::GetErrorBreakpoint

Gets the IDebugErrorBreakpoint2 interface that describes the warning or error.

Remarks

Whenever a breakpoint is bound, an event is sent to the SDM. If the breakpoint cannot be bound, an IDebugBreakpointErrorEvent2 is sent; otherwise, an IDebugBreakpointBoundEvent2 is sent.

For example, when the condition associated with the pending breakpoint fails to parse or evaluate, a warning is sent that the pending breakpoint cannot be bound at this time. This may occur if the code for the breakpoint has not loaded yet.

Requirements

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See Also

Reference

IDebugEvent2

IDebugErrorBreakpoint2

IDebugPendingBreakpoint2

IDebugBreakpointBoundEvent2

IDebugEventCallback2