GetBreakpointById

The GetBreakpointById and GetBreakpointById2 methods return the breakpoint with the specified breakpoint ID.

HRESULT
  IDebugControl::GetBreakpointById(
    IN ULONG  Id,
    OUT IDebugBreakpoint * *  Bp
    );

HRESULT
  IDebugControl4::GetBreakpointById2(
    IN ULONG  Id,
    OUT IDebugBreakpoint2 * *  Bp
    );

Parameters

Id

Specifies the breakpoint ID of the breakpoint to return.

Bp

Receives the breakpoint.

Return Value

S_OK

The method was successful.

E_NOINTERFACE

No breakpoint was found with the given ID, or the breakpoint with the specified ID does not belong to the current process, or the breakpoint with the given ID is private (see GetFlags).

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

Interface Version

GetBreakpointById is available in all versions of IDebugControl. GetBreakpointById2 is available in IDebugControl4 and later versions.

Comments

If the specified breakpoint does not belong to the current process, the GetBreakpointById and GetBreakpointById2 methods will fail.

Requirements

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

See Also

IDebugBreakpoint