CIM_OSVersionCheck class

The CIM_OSVersionCheck class specifies the versions of the operating system that can support a software element. The check can be run for a specific, minimum, maximum, or a range of operating system releases. To specify a specific operating system version, the minimum and maximum versions must be equal. To specify the minimum version, the minimum version only must be specified. To specify a maximum version, the maximum version only needs to be specified. To specify a range, both minimum and maximum versions must be specified.

The type of operating system is specified in the TargetOperatingSystem property of the owning software element. Details of the checks are compared with the corresponding details found in a CIM_OperatingSystem object referenced by a CIM_InstalledOS association for the CIM_ComputerSystem object that describes the environment. At least one CIM_OperatingSystem class must satisfy the details of the condition for the check to be satisfied. In other words, not all of the operating systems on the relevant computer system need to satisfy the condition. Also, the OSType property of the CIM_OperatingSystem class must match the type of the TargetOperatingSystem property.

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

class CIM_OSVersionCheck
{
  string  Caption;
  string  CheckID;
  boolean CheckMode;
  string  Description;
  string  MaximumVersion;
  string  MinimumVersion;
  string  Name;
  string  SoftwareElementID;
  uint16  SoftwareElementState;
  uint16  TargetOperatingSystem;
  string  Version;
};

Members

The CIM_OSVersionCheck class has these types of members:

Methods

The CIM_OSVersionCheck class has these methods.

MethodDescription
Invoke

Takes a particular action. Not implemented by WMI.

 

Properties

The CIM_OSVersionCheck class has these properties.

Caption
Data type: string
Access type: Read-only

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

CheckID
Data type: string
Access type: Read-only

Used in conjunction with other keys to uniquely identify the check. This property is inherited from CIM_Check.

CheckMode
Data type: boolean
Access type: Read-only

If TRUE, the condition is expected to exist in the environment (for example, if a file is on a system, the Invoke method should return TRUE). If FALSE, the condition should not exist (for example, if a file is not on a system, the Invoke method should return FALSE). This property is inherited from CIM_Check.

Description
Data type: string
Access type: Read-only

Description of the object. This property is inherited from CIM_Check.

MaximumVersion
Data type: string
Access type: Read-only

Maximum version of the required operating system.

The value is encoded in one of the following forms:

  • <major>.<minor>.<revision>
  • <major>.<minor><letter><revision>
MinimumVersion
Data type: string
Access type: Read-only

Minimum version of the required operating system.

The value is encoded in one of the following forms:

  • <major>.<minor>.<revision>
  • <major>.<minor><letter><revision>
Name
Data type: string
Access type: Read-only

Name used to identify the software element. This property is inherited from CIM_Check.

SoftwareElementID
Data type: string
Access type: Read-only

Identifier for the software element. This property is inherited from CIM_Check.

SoftwareElementState
Data type: uint16
Access type: Read-only

State of a software element. This property is inherited from CIM_Check.

ValueMeaning
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 this software element. This property is inherited from CIM_Check.

ValueMeaning
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>

This property is inherited from the CIM_Check class.

Remarks

WMI does not implement this class.

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 XP

Minimum supported server

Windows Server 2003

Namespace

\root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

 

 

Show:
© 2014 Microsoft