Export (0) Print
Expand All

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

class Win32_NamedJobObjectLimitSetting : CIM_Setting
{
  uint32 ActiveProcessLimit;
  uint32 Affinity;
  string Caption;
  string Description;
  uint32 JobMemoryLimit;
  uint32 LimitFlags;
  uint32 MaximumWorkingSetSize;
  uint64 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 description of the object—a one-line string. This property is inherited from CIM_ManagedSystemElement.

Description
Data type: string
Access type: Read-only

Description of the object. This property is inherited from CIM_ManagedSystemElement.

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

Bitmap that represents the job limits. One or more of the limits can be in effect at the same time.

ValueMeaning
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: uint64
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.

For more information about using uint64 values in scripts, see Scripting in WMI.

PerJobUserTimeLimit
Data type: uint64
Access type: Read-only
Qualifiers: Units (100ns)

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 (100ns)

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

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: Key, MaxLen (256)

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 2003

Namespace

\root\CIMV2

MOF

Wmipjobj.mof

DLL

Wmipjobj.dll

See also

Operating System Classes

 

 

Show:
© 2014 Microsoft