ICorDebugStackWalk::GetContext Method

Returns the context for the current frame in the ICorDebugStackWalk object.

Syntax

HRESULT GetContext([in]  ULONG32 contextFlags,
                   [in]  ULONG32 contextBufSize,
                   [out] ULONG32* contextSize,
                   [out, size_is(contextBufSize)] BYTE contextBuf[]);

Parameters

contextFlags [in] Flags that indicate the requested contents of the context buffer (defined in WinNT.h).

contextBufSize [in] The allocated size of the context buffer.

contextSize [out] The actual size of the context. This value must be less than or equal to the size of the context buffer.

contextBuf [out] The context buffer.

Return Value

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

HRESULT Description
S_OK The context for the current frame was successfully returned.
E_FAIL The context could not be returned.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT BUFFER) The context buffer is too small.
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

Because unwinding restores only a subset of the registers, such as non-volatile registers, the context may not exactly match the register state at the time of the call.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4

See also