ICorDebugVirtualUnwinder::GetContext Method

Article
09/15/2021

Gets the current context of this unwinder.

Syntax

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

Parameters

contextFlags [in] Flags that specify which parts of the context to return (defined in WinNT.h).

cbContextBuf [in] The number of bytes in contextBuf.

contextSize [out] A pointer to the number of bytes actually written to contextBuf.

contextBuf [out] A byte array that contains the current context of this unwinder.

Return Value

Any failing HRESULT value received by mscordbi is considered fatal and will cause ICorDebug APIs to return CORDBG_E_DATA_TARGET_ERROR.

Remarks

You set the initial value of the contextBuf argument to the context buffer returned by calling the ICorDebugStackWalk::GetContext method.

Note

This method is available with .NET Native only.

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

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4.6, .NET Native only

Share via