UnmapViewOfFileEx-Funktion (memoryapi.h)

Artikel
03/01/2024

Dies ist eine erweiterte Version von UnmapViewOfFile , die einen zusätzlichen Flags-Parameter akzeptiert.

Syntax

BOOL UnmapViewOfFileEx(
  [in] PVOID BaseAddress,
  [in] ULONG UnmapFlags
);

Parameter

[in] BaseAddress

Ein Zeiger auf die Basisadresse der zugeordneten Ansicht einer Datei, die nicht zugeordnet werden soll. Dieser Wert muss mit dem Wert identisch sein, der von einem vorherigen Aufruf einer der Funktionen in der MapViewOfFile-Familie zurückgegeben wurde.

[in] UnmapFlags

Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
MEM_UNMAP_WITH_TRANSIENT_BOOST 0x00000001	Gibt an, dass die Priorität der Seiten, die nicht zugeordnet werden, vorübergehend erhöht werden soll (mit automatischer kurzfristiger Verfall), da der Aufrufer erwartet, dass auf diese Seiten in Kürze von einem anderen Thread aus erneut zugegriffen wird. Weitere Informationen zu Speicherprioritäten finden Sie in der SetThreadInformation(ThreadMemoryPriority) -Funktion.
MEM_PRESERVE_PLACEHOLDER 0x00000002	Hebt die Zuordnung einer zugeordneten Ansicht wieder einem Platzhalter auf (nachdem Sie mithilfe von MapViewOfFile3 oder MapViewOfFile3FromApp einen Platzhalter durch eine zugeordnete Ansicht ersetzt haben).

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Weitere Informationen zum Verhalten dieser Funktion finden Sie in der UnmapViewOfFile-Funktion .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	memoryapi.h (einschließlich Windows.h, Memoryapi.h)
Bibliothek	onecore.lib
DLL	Kernel32.dll

Freigeben über