Fungsi QueryWorkingSet (psapi.h)
Mengambil informasi tentang halaman yang saat ini ditambahkan ke kumpulan kerja proses yang ditentukan.
Untuk mengambil informasi set kerja untuk subset alamat virtual, atau untuk mengambil informasi tentang halaman yang bukan bagian dari set kerja (seperti AWE atau halaman besar), gunakan fungsi QueryWorkingSetEx .
Sintaks
BOOL QueryWorkingSet(
[in] HANDLE hProcess,
[out] PVOID pv,
[in] DWORD cb
);
Parameter
[in] hProcess
Handel untuk proses. Handel harus memiliki hak akses PROCESS_QUERY_INFORMATION dan PROCESS_VM_READ . Untuk informasi selengkapnya, lihat Keamanan Proses dan Hak Akses.
[out] pv
Penunjuk ke buffer yang menerima informasi. Untuk informasi selengkapnya, lihat PSAPI_WORKING_SET_INFORMATION.
Jika buffer yang diacu oleh parameter pv tidak cukup besar untuk berisi semua entri set kerja untuk proses target, fungsi gagal dengan ERROR_BAD_LENGTH. Dalam hal ini, anggota NumberOfEntries dari struktur PSAPI_WORKING_SET_INFORMATION diatur ke jumlah entri yang diperlukan, tetapi fungsi tidak mengembalikan informasi tentang entri set kerja.
[in] cb
Ukuran buffer pv , dalam byte.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Dimulai dengan Windows 7 dan Windows Server 2008 R2, Psapi.h menetapkan nomor versi untuk fungsi PSAPI. Nomor versi PSAPI memengaruhi nama yang digunakan untuk memanggil fungsi dan pustaka yang harus dimuat program.
Jika PSAPI_VERSION adalah 2 atau lebih besar, fungsi ini didefinisikan sebagai K32QueryWorkingSet di Psapi.h dan diekspor di Kernel32.lib dan Kernel32.dll. Jika PSAPI_VERSION adalah 1, fungsi ini didefinisikan sebagai QueryWorkingSet di Psapi.h dan diekspor di Psapi.lib dan Psapi.dll sebagai pembungkus yang memanggil K32QueryWorkingSet.
Program yang harus berjalan pada versi Windows yang lebih lama serta Windows 7 dan versi yang lebih baru harus selalu memanggil fungsi ini sebagai QueryWorkingSet. Untuk memastikan resolusi simbol yang benar, tambahkan Psapi.lib ke makro TARGETLIBS dan kompilasi program dengan -DPSAPI_VERSION=1. Untuk menggunakan penautan dinamis run-time, muat Psapi.dll.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | psapi.h |
| Pustaka | Kernel32.lib pada Windows 7 dan Windows Server 2008 R2; Psapi.lib (jika PSAPI_VERSION=1) pada Windows 7 dan Windows Server 2008 R2; Psapi.lib di Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP |
| DLL | Kernel32.dll pada Windows 7 dan Windows Server 2008 R2; Psapi.dll (jika PSAPI_VERSION=1) pada Windows 7 dan Windows Server 2008 R2; Psapi.dll pada Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP |