共用方式為


SetInformationJobObject 函式 (jobapi2.h)

設定作業物件的限制。

語法

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

參數

[in] hJob

正在設定其限制之作業的句柄。 CreateJobObjectOpenJobObject 函式會傳回這個句柄。 句柄必須具有 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

另請參閱

JOBOBJECT_ASSOCIATE_COMPLETION_PORT

JOBOBJECT_BASIC_LIMIT_INFORMATION

JOBOBJECT_BASIC_UI_RESTRICTIONS

JOBOBJECT_CPU_RATE_CONTROL_INFORMATION

JOBOBJECT_END_OF_JOB_TIME_INFORMATION

JOBOBJECT_EXTENDED_LIMIT_INFORMATION

JOBOBJECT_LIMIT_VIOLATION_INFORMATION

JOBOBJECT_LIMIT_VIOLATION_INFORMATION_2

JOBOBJECT_NET_RATE_CONTROL_INFORMATION

JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION

JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2

JOBOBJECT_SECURITY_LIMIT_INFORMATION

作業物件

處理安全性和訪問許可權

處理序和執行緒函式

QueryInformationJobObject