ILanguageExceptionStackBackTrace::GetStackBackTrace method (restrictederrorinfo.h)

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

See also

ILanguageExceptionStackBackTrace