Fungsi QueryInformationJobObject (jobapi2.h)

Artikel
08/24/2023

Mengambil informasi batas dan status pekerjaan dari objek pekerjaan.

Sintaks

BOOL QueryInformationJobObject(
  [in, optional]  HANDLE             hJob,
  [in]            JOBOBJECTINFOCLASS JobObjectInformationClass,
  [out]           LPVOID             lpJobObjectInformation,
  [in]            DWORD              cbJobObjectInformationLength,
  [out, optional] LPDWORD            lpReturnLength
);

Parameter

[in, optional] hJob

Handel untuk pekerjaan yang informasinya sedang dikueri. Fungsi CreateJobObject atau OpenJobObject mengembalikan handel ini. Handel harus memiliki hak akses JOB_OBJECT_QUERY . Untuk informasi selengkapnya, lihat Keamanan Objek Pekerjaan dan Hak Akses.

Jika nilai ini NULL dan proses panggilan dikaitkan dengan pekerjaan, pekerjaan yang terkait dengan proses panggilan digunakan. Jika pekerjaan ditumpuk, pekerjaan langsung dari proses panggilan digunakan.

[in] JobObjectInformationClass

Kelas informasi untuk batas yang akan dikueri. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
JobObjectBasicAccountingInformation 1	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_BASIC_ACCOUNTING_INFORMATION .
JobObjectBasicAndIoAccountingInformation 8	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION .
JobObjectBasicLimitInformation 2	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_BASIC_LIMIT_INFORMATION .
JobObjectBasicProcessIdList 3	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_BASIC_PROCESS_ID_LIST .
JobObjectBasicUIRestrictions 4	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_BASIC_UI_RESTRICTIONS .
JobObjectCpuRateControlInformation 15	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_CPU_RATE_CONTROL_INFORMATION . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003, dan Windows XP: Bendera ini tidak didukung.
JobObjectEndOfJobTimeInformation 6	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_END_OF_JOB_TIME_INFORMATION .
JobObjectExtendedLimitInformation 9	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_EXTENDED_LIMIT_INFORMATION .
JobObjectGroupInformation 11	Parameter lpJobObjectInfo adalah penunjuk ke buffer yang menerima daftar grup prosesor tempat pekerjaan saat ini ditetapkan. Variabel yang diacu oleh parameter lpReturnLength diatur ke ukuran data grup. Bagi nilai ini dengan `sizeof(USHORT)` untuk menentukan jumlah grup. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Bendera ini tidak didukung.
JobObjectGroupInformationEx 14	Parameter lpJobObjectInfo adalah penunjuk ke buffer yang menerima array struktur GROUP_AFFINITY yang menunjukkan afinitas pekerjaan dalam grup prosesor tempat pekerjaan saat ini ditetapkan. Variabel yang diacu oleh parameter lpReturnLength diatur ke ukuran data afinitas grup. Bagi nilai ini dengan `sizeof(GROUP_AFFINITY)` untuk menentukan jumlah grup. Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003, dan Windows XP: Bendera ini tidak didukung.
JobObjectLimitViolationInformation 13	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_LIMIT_VIOLATION_INFORMATION . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003, dan Windows XP: Bendera ini tidak didukung.
JobObjectLimitViolationInformation2 34	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_LIMIT_VIOLATION_INFORMATION_2 . Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Bendera ini tidak didukung.
JobObjectNetRateControlInformation 32	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_NET_RATE_CONTROL_INFORMATION . Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Bendera ini tidak didukung.
JobObjectNotificationLimitInformation 12	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003, dan Windows XP: Bendera ini tidak didukung.
JobObjectNotificationLimitInformation2 33	Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2 . Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Bendera ini tidak didukung.
JobObjectSecurityLimitInformation 5	Bendera ini tidak didukung. Aplikasi harus menetapkan batas keamanan satu per satu untuk setiap proses. Windows Server 2003 dan Windows XP: Parameter lpJobObjectInfo adalah penunjuk ke struktur JOBOBJECT_SECURITY_LIMIT_INFORMATION .

[out] lpJobObjectInformation

Batas atau informasi status pekerjaan. Format data ini tergantung pada nilai parameter JobObjectInfoClass .

[in] cbJobObjectInformationLength

Jumlah informasi pekerjaan yang dikueri, dalam byte. Nilai ini tergantung pada nilai parameter JobObjectInfoClass .

[out, optional] lpReturnLength

Penunjuk ke variabel yang menerima panjang data yang ditulis ke struktur yang ditunjukkan oleh parameter lpJobObjectInfo . Tentukan NULL untuk tidak menerima informasi ini.

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

Gunakan QueryInformationJobObject untuk mendapatkan batas saat ini dan mengubahnya. Gunakan fungsi SetInformationJobObject untuk mengatur batas baru.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0500 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	jobapi2.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll