GetBreakpointParameters

The GetBreakpointParameters method returns the parameters of one or more breakpoints.

HRESULT
  IDebugControl::GetBreakpointParameters(
    IN ULONG  Count,
    IN OPTIONAL PULONG  Ids,
    IN ULONG  Start,
    OUT PDEBUG_BREAKPOINT_PARAMETERS  Params
    );

Parameters

Count

Specifies the number of breakpoints whose parameters are being requested.

Ids

Specifies an array containing the IDs of the breakpoints whose parameters are being requested. The number of items in this array must be equal to the value specified in Count. If Ids is NULL, Start is used instead.

Start

Specifies the beginning index of the breakpoints whose parameters are being requested. The parameters for breakpoints with indices Start through Start plus Count minus one will be returned. Start is used only if Ids is NULL.

Params

Receives the parameters for the specified breakpoints. The size of this array is equal to the value of Count. For details on the structure returned, see DEBUG_BREAKPOINT_PARAMETERS.

Return Value

S_OK

The method was successful.

S_FALSE

The method was successful. However, the parameters for some of the breakpoints were not returned. The parameters that were not returned have their Id field set to DEBUG_ANY_ID.

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

Interface Version

GetBreakpointParameters is available in all versions of IDebugControl.

Comments

Some of the parameters might not be returned. This happens if either a breakpoint could not be found or a breakpoint is private (see GetFlags).

Requirements

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

See Also

GetParameters, GetBreakpointById, GetBreakpointByIndex