QueryWorkingSet-Funktion (psapi.h)
Ruft Informationen zu den Seiten ab, die derzeit dem Arbeitssatz des angegebenen Prozesses hinzugefügt wurden.
Verwenden Sie die QueryWorkingSetEx-Funktion , um Arbeitssatzinformationen für eine Teilmenge virtueller Adressen abzurufen oder Informationen zu Seiten abzurufen, die nicht Teil des Arbeitssatzes sind (z. B. AWE oder große Seiten).
Syntax
BOOL QueryWorkingSet(
[in] HANDLE hProcess,
[out] PVOID pv,
[in] DWORD cb
);
Parameter
[in] hProcess
Ein Handle für den Prozess. Das Handle muss über die PROCESS_QUERY_INFORMATION - und PROCESS_VM_READ-Zugriffsrechte verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.
[out] pv
Ein Zeiger auf den Puffer, der die Informationen empfängt. Weitere Informationen finden Sie unter PSAPI_WORKING_SET_INFORMATION.
Wenn der Puffer, auf den der pv-Parameter verweist, nicht groß genug ist, um alle Arbeitssatzeinträge für den Zielprozess zu enthalten, schlägt die Funktion mit ERROR_BAD_LENGTH fehl. In diesem Fall ist das NumberOfEntries-Element der PSAPI_WORKING_SET_INFORMATION-Struktur auf die erforderliche Anzahl von Einträgen festgelegt, aber die Funktion gibt keine Informationen zu den Arbeitssatzeinträgen zurück.
[in] cb
Die Größe des pv-Puffers in Bytes.
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
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 K32QueryWorkingSet in Psapi.h definiert und in Kernel32.lib und Kernel32.dll exportiert. Wenn PSAPI_VERSION 1 ist, wird diese Funktion als QueryWorkingSet in Psapi.h definiert und in Psapi.lib und Psapi.dll als Wrapper exportiert, der K32QueryWorkingSet 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 QueryWorkingSet 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 |