Win32_NamedJobObjectLimitSetting class
The Win32_NamedJobObjectLimitSetting WMI class represents the limit settings for a job object.
The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties and methods are in alphabetic order, not MOF order.
Syntax
[Dynamic, Provider("NamedJobObjectLimitSettingProv"), UUID("{F2D96E32-2A34-475b-878D-B0AE7657519F}"), AMENDMENT]
class Win32_NamedJobObjectLimitSetting : CIM_Setting
{
string Caption;
string Description;
uint32 ActiveProcessLimit;
uint32 Affinity;
uint32 JobMemoryLimit;
uint32 LimitFlags;
uint32 MaximumWorkingSetSize;
uint32 MinimumWorkingSetSize;
uint64 PerJobUserTimeLimit;
uint64 PerProcessUserTimeLimit;
uint32 PriorityClass;
uint32 ProcessMemoryLimit;
uint32 SchedulingClass;
string SettingID;
};
Members
The Win32_NamedJobObjectLimitSetting class has these types of members:
Properties
The Win32_NamedJobObjectLimitSetting class has these properties.
-
ActiveProcessLimit
-
-
Data type: uint32
-
Access type: Read-only
Active process limit for a job. If associating a process with a job causes the active process count to exceed the limit, the process is terminated and the association fails. This property is ignored unless the LimitFlags property specifies the Active Process Limit value.
-
-
Affinity
-
-
Data type: uint32
-
Access type: Read-only
Processor affinity for all of the processes associated with a job. The affinity of each thread is set to this value, but threads are free to set the affinity subsequently, when it is a subset of the specified affinity mask. Processes cannot set an affinity mask. This property is ignored unless LimitFlags specifies the Limit Affinity value.
-
-
Caption
-
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64)
Short textual description of the CIM_Setting object.
This property is inherited from CIM_Setting.
-
-
Description
-
-
Data type: string
-
Access type: Read-only
Textual description of the CIM_Setting object.
This property is inherited from CIM_Setting.
-
-
JobMemoryLimit
-
-
Data type: uint32
-
Access type: Read-only
Per-job memory limit in kilobytes. This property is ignored unless LimitFlags specifies the Limit Job Memory value.
-
-
LimitFlags
-
-
Data type: uint32
-
Access type: Read-only
-
Qualifiers: BitValues ("Limit Working Set", "Limit Process Time", "Limit Job Time", "Active Process Limit", "Limit Affinity", "Limit Priority Class", "Limit Preserve Job Time", "Limit Scheduling Class", "Limit Process Memory", "Limit Job Memory", "Limit Die On Unhandled Exception", "Limit Breakaway OK", "Silent Breakaway OK")
Bitmap that represents the job limits. One or more of the limits can be in effect at the same time.
-
-
1 (0x1)
-
Limit Working Set
Causes all of the processes associated with the job to use the same minimum and maximum working set sizes.
-
2 (0x2)
-
Limit Process Time
Establishes a user-mode execution time limit for each currently active process and all of the future processes associated with a job.
-
4 (0x4)
-
Limit Job Time
Establishes a user-mode execution time limit for the job. This flag cannot be used with Limit Preserve Job Time.
-
8 (0x8)
-
Active Process Limit
Establishes a maximum number of simultaneously active processes associated with the job.
-
16 (0x10)
-
Limit Affinity
Causes all of the processes associated with the job to use the same processor affinity.
-
32 (0x20)
-
Limit Priority Class
Causes all of the processes associated with a job to use the same priority class.
-
64 (0x40)
-
Limit Preserve Job Time
Preserves any job time limits you set previously. When this flag is set, you can establish a per-job time limit one time, then alter other limits in subsequent calls. This flag cannot be used with Limit Job Time.
-
128 (0x80)
-
Limit Scheduling Class
Causes all of the processes in a job to use the same scheduling class.
-
256 (0x100)
-
Limit Process Memory
Causes all of the processes associated with a job to limit their committed memory. When a process attempts to commit memory that exceeds the perprocess limit, it fails. If the job object is associated with a completion port, a JOB_OBJECT_MSG_PROCESS_MEMORY_LIMIT message is sent to the completion port.
-
512 (0x200)
-
Limit Job Memory
Causes all of the processes associated with a job to limit the job-wide sum of the committed memory. When a process attempts to commit memory that exceeds the job-wide limit, it fails. If the job object is associated with a completion port, a JOB_OBJECT_MSG_JOB_MEMORY_LIMIT message is sent to the completion port.
-
1024 (0x400)
-
Limit Die On Unhandled Exception
Forces a call to the SetErrorMode function with the SEM_NOGPFAULTERRORBOX flag for each process associated with a job.
-
2048 (0x800)
-
Limit Breakaway OK
If any of the process associated with a job creates a child process using the CREATE_BREAKAWAY_FROM_JOB flag while this limit is in effect, the child process is not associated with the job.
-
4096 (0x1000)
-
Silent Breakaway OK
Allows any process associated with a job to create child processes that are not associated with the job.
MaximumWorkingSetSize
-
Data type: uint32
-
Access type: Read-only
Maximum working set size for all of the processes associated with a job. This property is ignored unless LimitFlags specifies the Limit Working Set value.
MinimumWorkingSetSize
-
Data type: uint32
-
Access type: Read-only
Minimum working set size for all of the processes associated with a job. This property is ignored unless LimitFlags specifies the Limit Working Set value.
PerJobUserTimeLimit
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Units ("100 nanoseconds")
Per-job user-mode execution time limit, in 100 nanosecond units. The system adds the current time of the processes associated with the job to this limit. For example, if you set this limit to 1 minute, and the job has a process that has accumulated 5 minutes of user mode time, the limit actually enforced is 6 minutes.
For more information about using uint64 values in scripts, see Scripting in WMI.
PerProcessUserTimeLimit
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Units ("100 nanoseconds")
Per-process user-mode execution time limit, in 100-nanosecond units. This property is ignored unless LimitFlags specifies Limit Process Time. The system periodically checks to determine whether or not each process associated with the job has accumulated more user-mode time than the set limit. If it has, the process is terminated.
For more information about using uint64 values in scripts, see Scripting in WMI.
PriorityClass
-
Data type: uint32
-
Access type: Read-only
Priority class for all of the processes associated with the job. Processes and threads cannot modify their priority class. This property is ignored unless LimitFlags specifies the Limit Priority value.
ProcessMemoryLimit
-
Data type: uint32
-
Access type: Read-only
-
Qualifiers: Units ("kilobytes")
Per-process memory limit in kilobytes. This property is ignored unless LimitFlags specifies the Limit Process Memory value.
SchedulingClass
-
Data type: uint32
-
Access type: Read-only
Scheduling class for all of the processes associated with the job. The valid values are 0 (zero) to 9 (nine). Use 0 (zero) for the least favorable scheduling class relative to other threads, and 9 (nine) for the most favorable scheduling class relative to other threads. This property is ignored unless LimitFlags specifies the Limit Scheduling Class value.
SettingID
Job object limit setting instance. Because they are kernel objects, job object names are case-sensitive. However, Windows Management Instrumentation (WMI) keys are case-insensitive and must be decorated to distinguish case. To indicate a capital letter, precede the letter by a backslash. For example, "A" and "a" are lowercase and "\A" and "\a" are uppercase.
Remarks
The Win32_NamedJobObjectLimitSetting class is derived from CIM_Setting.
Requirements
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|