Share via


ICorDebugStepper::StepRange Method

Causes this ICorDebugStepper to single-step through its containing thread, and to return when it reaches code beyond the last of the specified ranges.

HRESULT StepRange (
    [in] BOOL     bStepIn,
    [in, size_is(cRangeCount)] COR_DEBUG_STEP_RANGE ranges[],
    [in] ULONG32  cRangeCount
);

Parameters

  • bStepIn
    [in] Set to true to step into a function that is called within the thread. Set to false to step over the function.

  • ranges
    [in] An array of COR_DEBUG_STEP_RANGE structures, each of which specifies a range.

  • cRangeCount
    [in] The size of the ranges array.

Remarks

The StepRange method works like the ICorDebugStepper::Step method, except that it does not complete until code outside the given range is reached.

This can be more efficient than stepping one instruction at a time. Ranges are specified as a list of offset pairs from the start of the stepper's frame.

Ranges are relative to the Microsoft intermediate language (MSIL) code of a method. Call ICorDebugStepper::SetRangeIL with false to make the ranges relative to the native code of a method.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Version: 2.0, 1.1, 1.0

See Also

Concepts

ICorDebugStepper Interface

ICorDebugStepper2 Interface