ICorDebugStackWalk::SetContext Method

Article
09/15/2021

Sets the ICorDebugStackWalk object’s current context to a valid context for the thread.

Syntax

HRESULT SetContext([in] CorDebugSetContextFlag flag,
                   [in] ULONG32 contextSize,
                   [in, size_is(contextSize)] BYTE context[]);

Parameters

flag [in] A CorDebugSetContextFlag flag that indicates whether the context is from the active frame on the stack, or a context obtained by unwinding the stack.

contextSize [in] The allocated size of the CONTEXT buffer.

context [in] 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 `ICorDebugStackWalk` object's context was successfully set.
E_FAIL	The `ICorDebugStackWalk` object's context was not set.
E_INVALIDARG	The context is null.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	The context buffer is too small.

Exceptions

Remarks

This method does not alter the current context of the thread.

Setting the current context to an invalid context may cause unpredictable results from the stack walker.

You can retrieve an exact bitwise copy of this context by immediately calling the ICorDebugStackWalk::GetContext method.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4

Share via