Edit

Share via

IDebugControl3::GetBreakpointByIndex method (dbgeng.h)

  • Article

The GetBreakpointByIndex method returns the breakpoint located at the specified index.

Syntax

HRESULT GetBreakpointByIndex(
  [in]  ULONG             Index,
  [out] PDEBUG_BREAKPOINT *Bp
);

Parameters

[in] Index

Specifies the zero-based index of the breakpoint to return. This is specific to the current process. The value of Index should be between zero and the total number of breakpoints minus one. The total number of breakpoints can be determined by calling GetNumberBreakpoints.

[out] Bp

Receives the returned breakpoint.

Return value

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

Return code Description
S_OK
 The method was successful.
E_NOINTERFACE
 No breakpoint was found with the given index, or the breakpoint with the given index is private.

Remarks

The index and returned breakpoint are specific to the current process. The same index will return a different breakpoint if the current process is changed.

Requirements

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

See also

GetNumberBreakpoints

IDebugControl

IDebugControl2

IDebugControl3