RtlUnwindEx function

Initiates an unwind of procedure call frames.

Syntax

NTSYSAPI VOID RtlUnwindEx(
  PVOID                 TargetFrame,
  PVOID                 TargetIp,
  PEXCEPTION_RECORD     ExceptionRecord,
  PVOID                 ReturnValue,
  PCONTEXT              ContextRecord,
  PUNWIND_HISTORY_TABLE HistoryTable
);

Parameters

TargetFrame

A pointer to the call frame that is the target of the unwind. If this parameter is NULL, the function performs an exit unwind.

TargetIp

The continuation address of the unwind. This parameter is ignored if TargetFrame is NULL.

ExceptionRecord

A pointer to an EXCEPTION_RECORD structure.

ReturnValue

A value to be placed in the integer function return register before continuing execution.

ContextRecord

A pointer to a CONTEXT structure that stores context during the unwind operation.

HistoryTable

A pointer to the unwind history table. This structure is processor specific. For definitions of this structure, see Winternl.h.

Return Value

This function does not return a value.

Remarks

The FRAME_POINTERS structure is defined as follows:

typedef struct _FRAME_POINTERS {
    ULONGLONG MemoryStackFp;
    ULONGLONG BackingStoreFp;
} FRAME_POINTERS, *PFRAME_POINTERS;

Requirements

   
Target Platform Windows
Header winnt.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

CONTEXT

EXCEPTION_RECORD