SetInformationJobObject 函式 (jobapi2.h)

發行項
02/28/2024

設定作業物件的限制。

語法

BOOL SetInformationJobObject(
  [in] HANDLE             hJob,
  [in] JOBOBJECTINFOCLASS JobObjectInformationClass,
  [in] LPVOID             lpJobObjectInformation,
  [in] DWORD              cbJobObjectInformationLength
);

參數

[in] hJob

正在設定其限制之作業的句柄。 CreateJobObject 或 OpenJobObject 函式會傳回這個句柄。句柄必須具有 JOB_OBJECT_SET_ATTRIBUTES 訪問許可權。如需詳細資訊，請參閱作業物件安全性和訪問許可權。

[in] JobObjectInformationClass

要設定之限制的信息類別。此參數可以是下列其中一個值。

值	意義
JobObjectAssociateCompletionPortInformation 7	lpJobObjectInfo 參數是JOBOBJECT_ASSOCIATE_COMPLETION_PORT結構的指標。
JobObjectBasicLimitInformation 2	lpJobObjectInfo 參數是JOBOBJECT_BASIC_LIMIT_INFORMATION結構的指標。
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：不支援此旗標。如果已啟用動態公平共用排程 (DFSS) ，則無法設定 CPU 速率，且 SetInformationJobObject 將會失敗，錯誤碼為 50 (「不支援要求」) 。
JobObjectEndOfJobTimeInformation 6	lpJobObjectInfo 參數是JOBOBJECT_END_OF_JOB_TIME_INFORMATION 結構的指標。
JobObjectExtendedLimitInformation 9	lpJobObjectInfo 參數是JOBOBJECT_EXTENDED_LIMIT_INFORMATION結構的指標。
JobObjectGroupInformation 11	lpJobObjectInfo 參數是 USHORT 值的指標，指定要指派作業的處理器群組清單。 cbJobObjectInfoLength 參數會設定為群組數據的大小。將此值除以 `sizeof(USHORT)` 判斷群組數目。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支援此旗標。
JobObjectGroupInformationEx 14	lpJobObjectInfo 參數是緩衝區的指標，其中包含GROUP_AFFINITY結構的陣列，這些結構會為目前指派作業的處理器群組指定作業親和性。 cbJobObjectInfoLength 參數會設定為群組親和性數據的大小。將此值除以 `sizeof(GROUP_AFFINITY)` 判斷群組數目。 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結構的指標。 hJob 句柄必須具有與其相關聯的JOB_OBJECT_SET_SECURITY_ATTRIBUTES訪問許可權。

[in] lpJobObjectInformation

要為作業設定的限制或作業狀態。此數據的格式取決於 JobObjectInfoClass 的值。

[in] cbJobObjectInformationLength

所設定之作業資訊的大小，以位元組為單位。

傳回值

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

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

備註

使用 SetInformationJobObject 函式在單一呼叫中設定數個限制。若要一次建立一個限制或變更限制子集，請呼叫 QueryInformationJobObject 函式以取得目前的限制、修改這些限制，然後呼叫 SetInformationJobObject。

您必須針對與作業對象相關聯的每個進程個別設定安全性限制，而不是為作業物件本身設定安全性限制。如需詳細資訊，請參閱處理安全性和訪問許可權。

Windows Server 2003 和 Windows XP： 使用 SetInformationJobObject 函式來設定作業物件的安全性限制。

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

規格需求

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