Debugging Tools for Windows

RemoveBreakpoint

The RemoveBreakpoint and RemoveBreakpoint2 methods remove a breakpoint.

HRESULT
  IDebugControl::RemoveBreakpoint(
    IN IDebugBreakpoint *  Bp
    );

HRESULT
  IDebugControl4::RemoveBreakpoint2(
    IN IDebugBreakpoint2 *  Bp
    );

Parameters

Bp
Specifies an interface pointer to breakpoint to remove.

Return Value

S_OK
The method was successful.

This method may also return other error values. See Return Values for more details.

Interface Version

RemoveBreakpoint is available in all versions of IDebugControl. RemoveBreakpoint2 is available in IDebugControl4 and later versions.

Comments

After RemoveBreakpoint and RemoveBreakpoint2 are called, the breakpoint object specified in the Bp parameter must not be used again.

Note  Even though IDebugBreakpoint extends the COM interface IUnknown, the lifetime of the breakpoint is not controlled using the IUnknown interface. Instead, the breakpoint is deleted after RemoveBreakpoint and RemoveBreakpoint2 are called.

For more details, see Using Breakpoints.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

IDebugBreakpoint, AddBreakpoint

Build machine: CAPEBUILD