Edit

ICorDebugDataTarget2::CreateVirtualUnwinder Method

  • Article

Creates a new stack unwinder that starts unwinding from an initial context (which isn't necessarily the leaf of a thread).

Syntax

HRESULT CreateVirtualUnwinder(  
    [in] DWORD nativeThreadID,  
    [in] ULONG32 contextFlags,  
    [in] ULONG32 cbContext,  
    [in, size_is(cbContext)] BYTE initialContext[],  
    [out] ICorDebugVirtualUnwinder ** ppUnwinder);  
};

Parameters

nativeThreadID
[in] The native thread ID of the thread whose stack is to be unwound.

contextFlags
[in] Flags that specify which parts of the context are defined in initialContext.

cbContext
[in] The size of initialContext.

initialContext
[in] The data in the context.

ppUnwinder
[out] A pointer to the address of an ICorDebugVirtualUnwinder interface object.

Return Value

S_OK if successful. Any other HRESULT indicates failure. Any failing HRESULT received by mscordbi is considered fatal and causes ICorDebug methods to return CORDBG_E_DATA_TARGET_ERROR.

Remarks

Note

This method is available with .NET Native only.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

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

See also