Windows Dev Center

CIM_Check class

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.

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 inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

[UUID("{7A9135CA-DB21-11d2-85FC-0000F8102E5F}"), Abstract, AMENDMENT]
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.

MethodDescription
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
Qualifiers: Maxlen (64)

Short textual description of the object. This property is inherited from CIM_ManagedSystemElement.

CheckID
Data type: string
Access type: Read-only
Qualifiers: key, maxlen (256)

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
Qualifiers: Propagated ("CIM_SoftwareElement.Name") , CIM_key, maxlen (256)

Name used to identify the software element

SoftwareElementID
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.SoftwareElementID") , CIM_key, maxlen (256)

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
Qualifiers: Propagated ("CIM_SoftwareElement.SoftwareElementState") , CIM_key

Identifies various states of a software element's life cycle. This property is inherited from CIM_SoftwareElement.

ValueMeaning
Deployable
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).

Installable
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).

Executable
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).

Running
3

Running

Describes the details necessary to monitor and operate on a start element.

 

TargetOperatingSystem
Data type: uint16
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.TargetOperatingSystem") , CIM_key, Mappingstrings ("MIF.DMTF|Software Component Information|002.5")

Target operating system of the software element.

ValueMeaning
Unknown
0
Other
1
MACOS
2

Mac OS

ATTUNIX
3

ATT UNIX

DGUX
4
DECNT
5
Digital Unix
6
OpenVMS
7

Open VMS

HPUX
8

HP-UX

AIX
9
MVS
10
OS400
11
OS/2
12
JavaVM
13

Microsoft Virtual Machine (VM) for Java

MSDOS
14
WIN3x
15

Windows 3.x

WIN95
16

Windows 95

WIN98
17

Windows 98

WINNT
18

Windows NT

WINCE
19

Windows CE

NCR3000
20

NCR 3000

NetWare
21
OSF
22
DC/OS
23
Reliant UNIX
24
SCO UnixWare
25
SCO OpenServer
26
Sequent
27
IRIX
28
Solaris
29
SunOS
30
U6000
31
ASERIES
32

A Series

TandemNSK
33

Tandem NSK

TandemNT
34

Tandem NT

BS2000
35

BS2000/OSD

LINUX
36
Lynx
37
XENIX
38
VM/ESA
39
Interactive UNIX
40
BSDUNIX
41

BSD UNIX

FreeBSD
42
NetBSD
43
GNU Hurd
44
OS9
45

Mac OS 9

MACH Kernel
46
Inferno
47
QNX
48
EPOC
49
IxWorks
50
VxWorks
51
MiNT
52
BeOS
53
HP MPE
54
NextStep
55
PalmPilot
56

Palm OS

Rhapsody
57
Windows 2000
58
Dedicated
59
VSE
60
TPF
61

 

Version
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.Version") , CIM_key, Maxlen (64) , Mappingstrings ("MIF.DMTF|ComponentID|001.3")

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.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Namespace

Root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

 

 

Show:
© 2015 Microsoft