Edit

Share via

ICorDebugStackWalk::GetFrame Method

  • Article

Gets the current frame in the ICorDebugStackWalk object.

Syntax

HRESULT GetFrame([out] ICorDebugFrame ** pFrame);

Parameters

pFrame [in] A pointer to the address of the created frame object that represents the current frame in the stack.

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 returned the current frame.
E_FAIL The current frame was not returned.
S_FALSE The current frame is a native stack frame.
E_INVALIDARG pFrame is null.
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

ICorDebugStackWalk returns only actual stack frames. Use the ICorDebugThread3::GetActiveInternalFrames method to return internal frames. (Internal frames are data structures pushed onto the stack by the runtime to store temporary data.)

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4

See also