CIM_Check class
Applies to: desktop apps only
The CIM_Check class represents a condition or characteristic that is expected to be true in an environment defined or scoped by an instance of a CIM_ComputerSystem class. The checks associated with a particular software element are organized into one of two groups using the Phase property of the CIM_SoftwareElementChecks association.
Conditions that are expected to be satisfied when a software element is in a particular environment are known as in-state conditions. Conditions that must be satisfied to transition the current software element to its next state are known as next-state conditions.
A CIM_ComputerSystem object represents the environment in which a CIM_SoftwareElement is already installed, or in which a CIM_SoftwareElement will be installed. For the case in which a software element is already installed, the CIM_InstalledSoftwareElement association is used to identify the CIM_ComputerSystem object that represents the "environment." When a software element is being distributed and installed on a different computer, the CIM_ComputerSystem object for the targeted system is the environment.
The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.
Syntax
class CIM_Check
{
string Caption;
string CheckID;
boolean CheckMode;
string Description;
string Name;
string SoftwareElementID;
uint16 SoftwareElementState;
uint16 TargetOperatingSystem;
string Version;
};
Members
The CIM_Check class has these types of members:
Methods
The CIM_Check class has these methods.
| Method | Description |
|---|---|
| Invoke |
Takes a particular action. Not implemented by WMI. |
Properties
The CIM_Check class has these properties.
- Caption
-
- Data type: string
- Access type: Read-only
Short textual description of the object. This property is inherited from CIM_ManagedSystemElement.
- CheckID
-
- Data type: string
- Access type: Read-only
Identifier used in conjunction with other keys to uniquely identify the check.
- CheckMode
-
- Data type: boolean
- Access type: Read-only
If TRUE, the condition is expected to exist in the environment. For example, a file is expected to be on a system, so the Invoke method should return TRUE.
If FALSE, the condition is not expected to exist. For example, a file is not on a system, so the Invoke method should return FALSE.
- Description
-
- Data type: string
- Access type: Read-only
Description of the object. This property is inherited from CIM_ManagedSystemElement.
- Name
-
- Data type: string
- Access type: Read-only
Name used to identify the software element
- SoftwareElementID
-
- Data type: string
- Access type: Read-only
Identifier for the software element that can be used in conjunction with other keys to create a unique representation of the CIM_SoftwareElement. This property is inherited from CIM_SoftwareElement.
- SoftwareElementState
-
- Data type: uint16
- Access type: Read-only
Identifies various states of a software element's life cycle. This property is inherited from CIM_SoftwareElement.
Value Meaning - 0
Deployable
Describes the details necessary for successful distribution and the details (conditions and actions) required to create a software element in the installable state (that is, the next state).
- 1
Installable
Describes the details necessary for successful installation and the details (conditions and actions) required to create a software element in the executable state (that is, the next state).
- 2
Executable
Describes the details necessary for successful execution and the details (conditions and actions) required to create a software element in the running state (that is, the next state).
- 3
Running
Describes the details necessary to monitor and operate on a start element.
- TargetOperatingSystem
-
- Data type: uint16
- Access type: Read-only
Target operating system of the software element.
Value Meaning - 0
Unknown
- 1
Other
- 2
Mac OS
- 3
ATT UNIX
- 4
DGUX
- 5
DECNT
- 6
Digital UNIX
- 7
Open VMS
- 8
HP-UX
- 9
AIX
- 10
MVS
- 11
OS400
- 12
OS/2
- 13
Microsoft Virtual Machine (VM) for Java
- 14
MSDOS
- 15
Windows 3.x
- 16
Windows 95
- 17
Windows 98
- 18
Windows NT
- 19
Windows CE
- 20
NCR 3000
- 21
NetWare
- 22
OSF
- 23
DC/OS
- 24
Reliant UNIX
- 25
SCO UnixWare
- 26
SCO OpenServer
- 27
Sequent
- 28
IRIX
- 29
Solaris
- 30
SunOS
- 31
U6000
- 32
A Series
- 33
Tandem NSK
- 34
Tandem NT
- 35
BS2000/OSD
- 36
Linux
- 37
Lynx
- 38
Xenix
- 39
VM/ESA
- 40
Interactive UNIX
- 41
BSD UNIX
- 42
FreeBSD
- 43
NetBSD
- 44
GNU Hurd
- 45
Mac OS 9
- 46
Mach Kernel
- 47
Inferno
- 48
QNX
- 49
EPOC
- 50
IxWorks
- 51
VxWorks
- 52
MiNT
- 53
BeOS
- 54
HP MPE
- 55
NEXTSTEP
- 56
Palm OS
- 57
Rhapsody
- 58
Windows 2000
- 59
Dedicated
- 60
VSE
- 61
TPF
- Version
-
- Data type: string
- Access type: Read-only
Version of the operation.
The version of the operation should be in one of the following forms:
- <major>.<minor>.<revision>
- <major>.<minor><letter><revision>
Remarks
WMI does not implement this class. For more information about classes derived from CIM_Check, 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.
Examples
For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.
For C++ code examples, see WMI C++ Application Examples.
Requirements
|
Minimum supported client | Windows 2000 Professional |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Namespace |
\root\CIMV2 |
|
MOF |
|
|
DLL |
|
Send comments about this topic to Microsoft
Build date: 3/9/2012
