UnmapViewOfFileEx-Funktion (memoryapi.h)

  • Artikel

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