CIM_Process class

The CIM_Process class represents a single instance of a running program. A user typically sees a process as an application or task. A process is defined by a workspace of memory resources and environmental settings that are allocated to it. On a multitasking system, the workspace prevents intrusion of resources by other processes. Additionally, a process can execute as multiple threads, all which run within the same workspace.

Important

The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of its inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

[Abstract, UUID("{8502C566-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("Processes (CIM)"), AMENDMENT]
class CIM_Process : CIM_LogicalElement
{
  string   Caption;
  string   CreationClassName;
  datetime CreationDate;
  string   CSCreationClassName;
  string   CSName;
  string   Description;
  uint16   ExecutionState;
  string   Handle;
  datetime InstallDate;
  uint64   KernelModeTime;
  string   Name;
  string   OSCreationClassName;
  string   OSName;
  uint32   Priority;
  string   Status;
  datetime TerminationDate;
  uint64   UserModeTime;
  uint64   WorkingSetSize;
};

Members

The CIM_Process class has these types of members:

Properties

The CIM_Process class has these properties.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64), DisplayName ("Caption")

Short textual description of the object.

This property is inherited from CIM_ManagedSystemElement.

CreationClassName

Data type: string

Access type: Read-only

Qualifiers: CIM_Key, MaxLen (256), DisplayName ("Class Name")

Name of the class or subclass used in the creation of an instance. When used with other key properties of the class, this property allows all instances of the class and its subclasses to be uniquely identified.

CreationDate

Data type: datetime

Access type: Read-only

Qualifiers: Fixed, DisplayName ("CreationDate")

Time that the process began executing.

CSCreationClassName

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_OperatingSystem.CSCreationClassName"), CIM_Key, MaxLen (256), DisplayName ("Computer System Class Name")

Scoping computer system's creation class name.

CSName

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_OperatingSystem.CSName"), CIM_Key, MaxLen (256), DisplayName ("Computer System Name")

Scoping computer system's name.

Description

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Description")

Textual description of the object.

This property is inherited from CIM_ManagedSystemElement.

ExecutionState

Data type: uint16

Access type: Read-only

Qualifiers: DisplayName ("Execution State")

Current operating condition of the process.

Unknown (0)

Other (1)

Ready (2)

Running (3)

Blocked (4)

Suspended Blocked (5)

Suspended blocked

Suspended Ready (6)

Suspended ready

Terminated (7)

Stopped (8)

Growing (9)

Handle

Data type: string

Access type: Read-only

Qualifiers: Key, MaxLen (256), DisplayName ("Handle")

Identifies the process. A process identifier is a kind of process handle.

InstallDate

Data type: datetime

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Install Date")

Date and time the object was installed. This property does not need a value to indicate that the object is installed.

This property is inherited from CIM_ManagedSystemElement.

KernelModeTime

Data type: uint64

Access type: Read-only

Qualifiers: DisplayName ("Kernel Model Time"), Units ("milliseconds")

Time in kernel mode, in 100 nanosecond units. If this information is not available, a value of 0 (zero) should be used.

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

Name

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Name")

Label by which the object is known. When subclassed, this property can be overridden to be a key property.

This property is inherited from CIM_ManagedSystemElement.

OSCreationClassName

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_OperatingSystem.CreationClassName"), CIM_Key, MaxLen (256), DisplayName ("Operating System Class Name")

Scoping operating system's creation class name.

OSName

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_OperatingSystem.Name"), CIM_Key, MaxLen (256), DisplayName ("Operating System Name")

Scoping operating system's name.

Priority

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Priority")

Urgency or importance for process execution. If a priority is not defined for a process, a value of 0 (zero) should be used.

Status

Data type: string

Access type: Read-only

Qualifiers: MaxLen (10), DisplayName ("Status")

Current status of the object.

This property is inherited from CIM_ManagedSystemElement.

Values include the following:

OK ("OK")

Error ("Error")

Degraded ("Degraded")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Starting ("Starting")

Stopping ("Stopping")

Service ("Service")

Stressed ("Stressed")

NonRecover ("NonRecover")

No Contact ("No Contact")

Lost Comm ("Lost Comm")

TerminationDate

Data type: datetime

Access type: Read-only

Qualifiers: DisplayName ("Termination Date")

Time that the process was stopped or terminated.

UserModeTime

Data type: uint64

Access type: Read-only

Qualifiers: DisplayName ("User Mode Time"), Units ("milliseconds")

Time in user mode, in 100 nanosecond units. If this information is not available, a value of 0 (zero) should be used.

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

WorkingSetSize

Data type: uint64

Access type: Read-only

Qualifiers: DisplayName ("Working Set Size"), Units ("bytes")

Amount of memory, in bytes, that a process needs to execute efficiently for an operating system that uses page-based memory management. If the system does not have enough memory (less than the working set size), thrashing occurs. If the size of the working set is not known, use NULL or 0 (zero). If working set data is provided, you can monitor the information to understand the changing memory requirements of a process.

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

Remarks

The CIM_Process class is derived from CIM_LogicalElement.

WMI does not implement this class. For WMI classes derived from CIM_Process, see Win32 Classes.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

See also

CIM_LogicalElement