IDebugEventCallbacksWide::Breakpoint method

The Breakpoint callback method is called by the engine when the target issues a breakpointexception.

Syntax

HRESULT Breakpoint(
  PDEBUG_BREAKPOINT2 Bp
);

Parameters

Bp

Specifies a pointer to the IDebugBreakpoint object corresponding to the breakpoint that was triggered.

Return Value

This method returns a DEBUG_STATUS_XXX value, which indicates how the execution of the target should proceed after the engine processes this event. For details on how the engine treats this value, see Monitoring Events.

Remarks

If the breakpoint has an associated command, the engine executes that command before calling this method.

The engine will only call this method if an IDebugBreakpoint object corresponding to the breakpoint exists in the engine, and--if the breakpoint is a private breakpoint--this IDebugEventCallbacksWide object was registered with the client that added the breakpoint.

The engine calls this method only if the DEBUG_EVENT_BREAKPOINT flag is set in the mask returned by IDebugEventCallbacksWide::GetInterestMask.

Because the engine deletes the corresponding IDebugBreakpoint object when a breakpoint is removed (for example, by using RemoveBreakpoint), the value of Bp might be invalid after Breakpoint returns. Therefore, implementations of IDebugEventCallbacksWide should not access Bp after Breakpoint returns.

For more information about handling events, see Monitoring Events. For information about managing breakpoints, see Breakpoints.

Requirements

   
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)