QueryInformationJobObject 函式 (jobapi2.h)

發行項
03/11/2023

從工作物件擷取限制和作業狀態資訊。

語法

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

參數

[in, optional] hJob

正在查詢其資訊的作業控制碼。 CreateJobObject或OpenJobObject函式會傳回此控制碼。控制碼必須具有 JOB_OBJECT_QUERY 存取權限。如需詳細資訊，請參閱工作物件安全性和存取權限。

如果此值為 Null，且呼叫進程與作業相關聯，則會使用與呼叫進程相關聯的作業。如果作業是巢狀的，則會使用呼叫進程的立即作業。

[in] JobObjectInformationClass

要查詢之限制的資訊類別。此參數可以是下列其中一個值。

值	意義
JobObjectBasicAccountingInformation 1	lpJobObjectInfo參數是JOBOBJECT_BASIC_ACCOUNTING_INFORMATION結構的指標。
JobObjectBasicAndIoAccountingInformation 8	lpJobObjectInfo參數是JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION結構的指標。
JobObjectBasicLimitInformation 2	lpJobObjectInfo參數是JOBOBJECT_BASIC_LIMIT_INFORMATION結構的指標。
JobObjectBasicProcessIdList 3	lpJobObjectInfo參數是JOBOBJECT_BASIC_PROCESS_ID_LIST結構的指標。
JobObjectBasicUIRestrictions 4	lpJobObjectInfo參數是JOBOBJECT_BASIC_UI_RESTRICTIONS結構的指標。
JobObjectCpuRateControlInformation 15	lpJobObjectInfo參數是JOBOBJECT_CPU_RATE_CONTROL_INFORMATION結構的指標。 Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支援此旗標。
JobObjectEndOfJobTimeInformation 6	lpJobObjectInfo參數是JOBOBJECT_END_OF_JOB_TIME_INFORMATION結構的指標。
JobObjectExtendedLimitInformation 9	lpJobObjectInfo參數是JOBOBJECT_EXTENDED_LIMIT_INFORMATION結構的指標。
JobObjectGroupInformation 11	lpJobObjectInfo參數是緩衝區的指標，可接收目前指派作業的處理器群組清單。 lpReturnLength參數所指向的變數會設定為群組資料的大小。將此值除 `sizeof(USHORT)` 以判斷群組數目。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支援此旗標。
JobObjectGroupInformationEx 14	lpJobObjectInfo參數是緩衝區的指標，可接收GROUP_AFFINITY結構的陣列，指出目前指派作業之處理器群組中作業的親和性。 lpReturnLength參數所指向的變數會設定為群組親和性資料的大小。將此值除 `sizeof(GROUP_AFFINITY)` 以判斷群組數目。 Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支援此旗標。
JobObjectLimitViolationInformation 13	lpJobObjectInfo參數是JOBOBJECT_LIMIT_VIOLATION_INFORMATION結構的指標。 Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支援此旗標。
JobObjectLimitViolationInformation2 34	lpJobObjectInfo參數是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 和 Windows XP：不支援此旗標。
JobObjectNetRateControlInformation 32	lpJobObjectInfo參數是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 和 Windows XP：不支援此旗標。
JobObjectNotificationLimitInformation 12	lpJobObjectInfo參數是JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION結構的指標。 Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支援此旗標。
JobObjectNotificationLimitInformation2 33	lpJobObjectInfo參數是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 和 Windows XP：不支援此旗標。
JobObjectSecurityLimitInformation 5	不支援此旗標。應用程式必須針對每個進程個別設定安全性限制。 Windows Server 2003 和 Windows XP：lpJobObjectInfo參數是JOBOBJECT_SECURITY_LIMIT_INFORMATION結構的指標。

[out] lpJobObjectInformation

限制或作業狀態資訊。此資料的格式取決於 JobObjectInfoClass 參數的值。

[in] cbJobObjectInformationLength

要查詢的作業資訊計數，以位元組為單位。此值取決於 JobObjectInfoClass 參數的值。

[out, optional] lpReturnLength

變數的指標，接收 寫入至 lpJobObjectInfo 參數所指向之結構的資料長度。指定 Null 以不接收這項資訊。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

使用 QueryInformationJobObject 來取得目前的限制並加以修改。使用 SetInformationJobObject 函式來設定新的限制。

若要編譯使用此函式的應用程式，請將 _WIN32_WINNT 定義為0x0500或更新版本。如需詳細資訊，請參閱使用 Windows 標頭。

需求


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	jobapi2.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll