IXCLRDataStackWalk::Next Method

Attempts to advance the stack walk to the next frame that matches the stack walk's filter. If the current frame type is CLRDATA_UNRECOGNIZED_FRAME, the Next method will be unable to advance. (The debugger will have to walk the unrecognized frame itself, reset the walk's context, and try again).

Note that upon creation, the stack walk is positioned "before" the first frame on the stack. Debuggers must call the Next method to advance to the first frame before any other functions will work. The function will output S_FALSE when there are no more frames that meet its filter criteria.

Note

This API was originally designed for internal use in the runtime. Although it is now supported for 3rd party use, we recommend working with ICorDebug and ICorProfiler APIs when possible.

Syntax

HRESULT Next();

Parameters

None

Remarks

The provided method is part of the IXCLRDataStackWalk interface and corresponds to the 6th slot of the virtual method table.

Requirements

Platforms: See System Requirements.
Header: None
Library: None
.NET Framework Versions: Available since 4.7

See also