UnmapViewOfFile2 function

Unmaps a previously mapped view of a file or a pagefile-backed section.

Syntax

BOOL UnmapViewOfFile2(
  HANDLE Process,
  PVOID  BaseAddress,
  ULONG  UnmapFlags
);

Parameters

Process

A HANDLE to the process from which the section will be unmapped.

BaseAddress

The base address of a previously mapped view that is to be unmapped. This value must be identical to the value returned by a previous call to MapViewOfFile2.

UnmapFlags

This parameter can be zero (0) or one of the following values.

Value Meaning
MEM_UNMAP_WITH_TRANSIENT_BOOST
0x00000001
Specifies that the priority of the pages being unmapped should be temporarily boosted (with automatic short term decay) because the caller expects that these pages will be accessed again shortly from another thread. For more information about memory priorities, see the SetThreadInformation(ThreadMemoryPriority) function.
MEM_PRESERVE_PLACEHOLDER
0x00000002
Unmaps a mapped view back to a placeholder (after you've replaced a placeholder with a mapped view using MapViewOfFile2 or MapViewOfFile2FromApp).

Return Value

Returns TRUE if sucessful. Otherwise, returns FALSE and extended error status is available using GetLastError.

Requirements

   
Minimum supported client Windows 10, version 1703 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header memoryapi.h (include Windows.h, Memoryapi.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

MapViewOfFile2

UnmapViewOfFile

UnmapViewOfFileEx