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

Data type: string

Access type: Read-only

Qualifiers: Override (SettingID), Key

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
Wmipjobj.mof
DLL
Wmipjobj.dll

See also

CIM_Setting

Operating System Classes