This topic has not yet been rated - Rate this topic

RtlUnwind2 function

Applies to: desktop apps only

Initiates an unwind of procedure call frames.

Syntax

void WINAPI RtlUnwind2(
  __in_opt  FRAME_POINTERS TargetFrame,
  __in_opt  PVOID TargetIp,
  __in_opt  PEXCEPTION_RECORD ExceptionRecord,
  __in      PVOID ReturnValue,
  __in      PCONTEXT OriginalContext
);

Parameters

TargetFrame [in, optional]

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 [in, optional]

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

ExceptionRecord [in, optional]

A pointer to an EXCEPTION_RECORD structure.

ReturnValue [in]

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

OriginalContext [in]

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

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

Product

Intel Itanium edition of Windows Server 2003 or Windows XP

Header

Winnt.h

Library

Kernel32.lib

DLL

Kernel32.dll

See also

CONTEXT
EXCEPTION_RECORD

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
rtlunwind2
void WINAPI RtlUnwind2(
  __in_opt  FRAME_POINTERS TargetFrame,
  __in_opt  PVOID TargetIp,
  __in_opt  PEXCEPTION_RECORD ExceptionRecord,
  __in      PVOID ReturnValue,
  __in      PCONTEXT OriginalContext
);