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  CheckID;
  string  Caption;
  string  Description;
  boolean CheckMode;
  string  Name;
  uint16  TargetOperatingSystem;
  string  Version;
  string  SoftwareElementID;
  uint16  SoftwareElementState;
};

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

Qualifiers: Maxlen (64)

A short textual description of the subject.

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

A description of the objects.

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)

This is an identifier for this software element.

SoftwareElementState

Data type: uint16

Access type: Read-only

Qualifiers: Propagated ("CIM_SoftwareElement.SoftwareElementState"), CIM_key

The software element state of a software element.

Deployable (0)

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)

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)

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)

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.

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

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