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
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for