IDebugBreakpointErrorEvent2

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 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.

Syntax

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
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