RoInspectCapturedStackBackTrace function

Provides a way to for debuggers to inspect a call stack from a target process.

Syntax


HRESULT WINAPI RoInspectCapturedStackBackTrace(
  _In_     UINT                     *targetErrorInfoAddress,
           USHORT                   machine,
           PINSPECT_MEMORY_CALLBACK readMemoryCallback,
  _In_opt_ VOID                     *context,
  _Out_    UINT32                   *frameCount,
  _Out_    UINT                     **targetBackTraceAddress
);

Parameters

targetErrorInfoAddress [in]: The address of the error info object in the target process. Get the targetErrorInfoAddress by calling the RoInspectThreadErrorInfo function.
machine: The machine to debug.
readMemoryCallback: A callback function to read the buffer from the target TEB address space.
context [in, optional]: Custom context data.
frameCount [out]: The number of stack frames stored in the error object.
targetBackTraceAddress [out]: The stack back trace address in the target process.

Return value

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

Remarks

The RoInspectCapturedStackBackTrace function takes a pointer to a system error object and fills frameCount with the number of stack frames stored in the error object, and it fills targetBackTraceAddress with the stack back trace address in the target process. The RoInspectCapturedStackBackTrace function tries to confirm that targetErrorInfoAddress points is to a system error object and fails if it can't match the version signature.

Get the targetErrorInfoAddress by calling the RoInspectThreadErrorInfo function.

Requirements

Minimum supported client	Windows 8.1 [desktop apps only]
Minimum supported server	Windows Server 2012 R2 [desktop apps only]
Header	Roerrorapi.h
Library	RuntimeObject.lib
DLL	ComBase.dll