Edit

SetProcessDynamicEHContinuationTargets function (processthreadsapi.h)

  • Article

Sets dynamic exception handling continuation targets for the specified process.

Syntax

BOOL SetProcessDynamicEHContinuationTargets(
  HANDLE                                  Process,
  USHORT                                  NumberOfTargets,
  PPROCESS_DYNAMIC_EH_CONTINUATION_TARGET Targets
);

Parameters

Process

A handle to the process. This handle must have the PROCESS_SET_INFORMATION access right. For more information, see Process Security and Access Rights.

NumberOfTargets

Supplies the number of dynamic exception handling continuation targets to set.

Targets

A pointer to an array of dynamic exception handling continuation targets. For more information on this structure, see PROCESS_DYNAMIC_EH_CONTINUATION_TARGET.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError. Note that even if the function fails, a portion of the supplied continuation targets may have been successfully processed. The caller needs to check the flags in each individual continuation target specified via Targets to determine if it was successfully processed.

Remarks

If user-mode Hardware-enforced Stack Protection is enabled for a process, when calling APIs that modify the execution context of a thread such as RtlRestoreContext and SetThreadContext, validation is performed on the Instruction Pointer specified in the new execution context. RtlRestoreContext is used during Structured Exception Handling (SEH) exception unwinding to unwind to the target frame that contains the __except block and to start executing code at the continuation target. Therefore, the operating system needs to know the instruction addresses of all the valid continuation targets in order to allow the unwind operation via RtlRestoreContext. For compiled binaries, the list of continuation targets is generated by the linker and stored in the binary image. For dynamic code, the continuation targets need to be specified using SetProcessDynamicEHContinuationTargets.

Requirements

Requirement Value
Minimum supported client Windows 10 Build 20348
Minimum supported server Windows 10 Build 20348
Header processthreadsapi.h