Edit

Share via

ILanguageExceptionStackBackTrace::GetStackBackTrace method (restrictederrorinfo.h)

  • Article

Retrieves the back stack trace.

Syntax

HRESULT GetStackBackTrace(
  [in]      ULONG       maxFramesToCapture,
  [in, out] UINT_PTR [] stackBackTrace,
  [out]     ULONG       *framesCaptured
);

Parameters

[in] maxFramesToCapture

The maximum number of frames to capture.

[in, out] stackBackTrace

An array containing the stack back trace; the maximum size is the maxFramesToCapture.

[out] framesCaptured

On success, contains a pointer to the number of frames actually captured.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

You should implement GetStackBackTrace in your language projections when the Global Error Handler surface is unable to capture a backtrace. GetStackBackTrace is called by the RoOriginateLanguageException export and by CapturePropagationContext when those functions detect, through querying for interface (QI), that the language exception provided to them implements it.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1703 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header restrictederrorinfo.h

See also

ILanguageExceptionStackBackTrace