ICorDebugStackWalk::GetContext Method
Returns the context for the current frame in the ICorDebugStackWalk object.
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. |
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 .NET Framework System Requirements.
Header: CorDebug.idl, CorDebug.h
Library: CorGuids.lib
.NET Framework Versions: 4