VirtualUnlock-Funktion (memoryapi.h)

  • Artikel

Entsperrt einen angegebenen Seitenbereich im virtuellen Adressraum eines Prozesses, sodass das System die Seiten bei Bedarf in die Auslagerungsdatei austauschen kann.

Syntax

BOOL VirtualUnlock(
  [in] LPVOID lpAddress,
  [in] SIZE_T dwSize
);

Parameter

[in] lpAddress

Ein Zeiger auf die Basisadresse des Bereichs der zu entsperrenden Seiten.

[in] dwSize

Die Größe der entsperrten Region in Bytes. Der Bereich der betroffenen Seiten umfasst alle Seiten, die mindestens ein Bytes im Bereich vom parameter lpAddress bis zu (lpAddress+dwSize)enthalten. Dies bedeutet, dass ein 2-Byte-Bereich, der eine Seitengrenze überspannt, dazu führt, dass beide Seiten entsperrt werden.

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

Damit die Funktion erfolgreich ist, muss der angegebene Bereich nicht mit einem Bereich übereinstimmen, der an einen vorherigen Aufruf der VirtualLock-Funktion übergeben wurde, aber alle Seiten im Bereich müssen gesperrt sein. Wenn eine der Seiten im angegebenen Bereich nicht gesperrt ist, entfernt VirtualUnlock diese Seiten aus dem Arbeitssatz, legt den letzten Fehler auf ERROR_NOT_LOCKED fest und gibt FALSE zurück.

Beim Aufrufen von VirtualUnlock in einem nicht gesperrten Speicherbereich werden die Seiten aus dem Arbeitssatz des Prozesses freigegeben.

Anforderungen

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

Siehe auch

Speicherverwaltungsfunktionen

Funktionen des virtuellen Speichers

VirtualLock