UnmapViewOfFileEx function

This is an extended version of UnmapViewOfFile that takes an additional flags parameter.

Syntax

BOOL UnmapViewOfFileEx(
  PVOID BaseAddress,
  ULONG UnmapFlags
);

Parameters

BaseAddress

A pointer to the base address of the mapped view of a file that is to be unmapped. This value must be identical to the value returned by a previous call to the MapViewOfFile or MapViewOfFileEx function.

UnmapFlags

This parameter can be 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

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.

Remarks

For more information about the behavior of this function, see the UnmapViewOfFile function.

Requirements

   
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header memoryapi.h (include Windows.h, Memoryapi.h)
Library Kernel32.lib
DLL Kernel32.dll