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
