nf-memoryapi-setprocessvalidcalltargets.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:memoryapi.SetProcessValidCallTargets	SetProcessValidCallTargets function (memoryapi.h)	Provides Control Flow Guard (CFG) with a list of valid indirect call targets and specifies whether they should be marked valid or not.	SetProcessValidCallTargets SetProcessValidCallTargets function base.setprocessvalidcalltargets winbase/SetProcessValidCallTargets	base\setprocessvalidcalltargets.htm	base	A28BBE75-5188-452B-B784-B6824D4BD161	12/05/2018	SetProcessValidCallTargets, SetProcessValidCallTargets function, base.setprocessvalidcalltargets, winbase/SetProcessValidCallTargets	memoryapi.h	Windows.h, Memoryapi.h	Windows	Windows 10 [desktop apps \| UWP apps]	Windows Server 2016 [desktop apps \| UWP apps]										WindowsApp.lib	Kernelbase.dll		Windows			19H1	SetProcessValidCallTargets memoryapi/SetProcessValidCallTargets	c++	APIRef kbSyntax	DllExport	kernelbase.dll API-MS-Win-Core-Memory-L1-1-3.dll API-MS-Win-Core-Memory-L1-1-4.dll	SetProcessValidCallTargets

SetProcessValidCallTargets function

-description

Provides Control Flow Guard (CFG) with a list of valid indirect call targets and specifies whether they should be marked valid or not. The valid call target information is provided as a list of offsets relative to a virtual memory range (start and size of the range). The call targets specified should be 16-byte aligned and in ascending order.

-parameters

-param hProcess [in]

The handle to the target process.

-param VirtualAddress [in]

The start of the virtual memory region whose call targets are being marked valid. The memory region must be allocated using one of the executable memory protection constants.

-param RegionSize [in]

The size of the virtual memory region.

-param NumberOfOffsets [in]

The number of offsets relative to the virtual memory ranges.

-param OffsetInformation [in, out]

A list of offsets and flags relative to the virtual memory ranges.

-returns

TRUE if the operation was successful; otherwise, FALSE. To retrieve error values for this function, call GetLastError.

-remarks

This function does not succeed if Control Flow Guard is not enabled for the target process. This can be checked using GetProcessMitigationPolicy.