ICorDebugStackWalk::Next Method

Moves the ICorDebugStackWalk object to the next frame.

Syntax

HRESULT Next();

Return Value

This method returns the following specific HRESULTs as well as HRESULT errors that indicate method failure.

HRESULT Description
S_OK The runtime successfully unwound to the next frame (see Remarks).
E_FAIL The ICorDebugStackWalk object could not be advanced.
CORDBG_S_AT_END_OF_STACK The end of the stack was reached as a result of this unwind.
CORDBG_E_PAST_END_OF_STACK The frame pointer is already at the end of the stack; therefore, no additional frames can be accessed.

Exceptions

Remarks

The Next method advances the ICorDebugStackWalk object to the calling frame only if the runtime can unwind the current frame. Otherwise, the object advances to the next frame that the runtime is able to unwind.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4

See also