EmptyWorkingSet-Funktion (psapi.h)
Entfernt so viele Seiten wie möglich aus dem Arbeitssatz des angegebenen Prozesses.
Syntax
BOOL EmptyWorkingSet(
[in] HANDLE hProcess
);
Parameter
[in] hProcess
Ein Handle für den Prozess. Das Handle muss über das PROCESS_QUERY_INFORMATION - oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht und das zugriffsrecht PROCESS_SET_QUOTA verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.
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
Sie können den Arbeitssatz auch leeren, indem Sie die SetProcessWorkingSetSize - oder SetProcessWorkingSetSizeEx-Funktion aufrufen, wobei die Parameter dwMinimumWorkingSetSize und dwMaximumWorkingSetSize auf den Wert (SIZE_T)(-1)festgelegt sind.
Ab Windows 7 und Windows Server 2008 R2 richtet Psapi.h Versionsnummern für die PSAPI-Funktionen ein. Die PSAPI-Versionsnummer wirkt sich auf den Namen aus, der zum Aufrufen der Funktion und der Bibliothek verwendet wird, die ein Programm laden muss.
Wenn PSAPI_VERSION 2 oder höher ist, wird diese Funktion als K32EmptyWorkingSet in Psapi.h definiert und in Kernel32.lib und Kernel32.dll exportiert. Wenn PSAPI_VERSION 1 ist, wird diese Funktion als K32EmptyWorkingSet in Psapi.h definiert und in Psapi.lib exportiert und Psapi.dll als Wrapper, der K32EmptyWorkingSet aufruft.
Programme, die unter früheren Versionen von Windows sowie windows 7 und höheren Versionen ausgeführt werden müssen, sollten diese Funktion immer als K32EmptyWorkingSet aufrufen. Um die richtige Auflösung von Symbolen sicherzustellen, fügen Sie dem TARGETLIBS-Makro Psapi.lib hinzu, und kompilieren Sie das Programm mit -DPSAPI_VERSION=1. Laden Sie Psapi.dll, um dynamische Laufzeitverknüpfung zu verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | psapi.h |
| Bibliothek | Kernel32.lib unter Windows 7 und Windows Server 2008 R2; Psapi.lib (wenn PSAPI_VERSION=1) unter Windows 7 und Windows Server 2008 R2; Psapi.lib unter Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP |
| DLL | Kernel32.dll unter Windows 7 und Windows Server 2008 R2; Psapi.dll (wenn PSAPI_VERSION=1) unter Windows 7 und Windows Server 2008 R2; Psapi.dll unter Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP |