Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

CIM_SoftwareElement class

The CIM_SoftwareElement class decomposes a CIM_SoftwareFeature object into a set of individually manageable or deployable parts for a particular platform. A software element's platform is uniquely identified by its underlying hardware architecture and operating system.

As such, to understand the details of how the functionality of a particular software feature is provided on a particular platform, the CIM_SoftwareElement objects referenced by CIM_SoftwareFeatureSoftwareElements associations are organized in disjoint sets based on the TargetOperatingSystem property. A CIM_SoftwareElement object captures the management details of a part or component in one of four states characterized by the SoftwareElementState 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 of its inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

[abstract, UUID("{8502C561-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_SoftwareElement : CIM_LogicalElement
{
  string   BuildNumber;
  string   Caption;
  string   CodeSet;
  string   Description;
  string   IdentificationCode;
  datetime InstallDate;
  string   LanguageEdition;
  string   Manufacturer;
  string   Name;
  string   OtherTargetOS;
  string   SerialNumber;
  string   SoftwareElementID;
  uint16   SoftwareElementState;
  string   Status;
  uint16   TargetOperatingSystem;
  string   Version;
};

Members

The CIM_SoftwareElement class has these types of members:

Properties

The CIM_SoftwareElement class has these properties.

BuildNumber
Data type: string
Access type: Read-only
Qualifiers: Maxlen (64) , Mappingstrings ("MIF.DMTF|Software Component Information|002.4")

Internal identifier for the compilation of this software element.

Caption
Data type: string
Access type: Read-only

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

CodeSet
Data type: string
Access type: Read-only
Qualifiers: Maxlen (64)

Code set used by the software element.

Description
Data type: string
Access type: Read-only

Textual description of the object. This property is inherited from CIM_ManagedSystemElement.

IdentificationCode
Data type: string
Access type: Read-only
Qualifiers: Maxlen (64) , Mappingstrings ("MIF.DMTF|Software Component Information|002.7")

Manufacturer's identifier for the software element, often a stock-keeping unit (SKU) or part number.

InstallDate
Data type: datetime
Access type: Read-only

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.

LanguageEdition
Data type: string
Access type: Read-only
Qualifiers: Maxlen (32) , Mappingstrings ("MIF.DMTF|Software Component Information|002.6")

Language edition of the software element. The language codes defined in ISO 639 should be used. Where the software element represents multilingual or international versions of a product, the string "multilingual" should be used.

Manufacturer
Data type: string
Access type: Read-only
Qualifiers: Maxlen (256) , Mappingstrings ("MIF.DMTF|ComponentID|001.1")

Manufacturer of the software element.

Name
Data type: string
Access type: Read-only
Qualifiers: key, maxlen (256) , override ("Name")

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

OtherTargetOS
Data type: string
Access type: Read-only
Qualifiers: Maxlen (64) , ModelCorrespondence ("CIM_OperatingSystem.OtherTypeDescription")

Manufacturer and operating system type for a software element when the TargetOperatingSystem property has a value of 1 ("Other"). When the TargetOperatingSystem property has a value of 1, this property must have a non-null value. For all other TargetOperatingSystem values, this property is null.

SerialNumber
Data type: string
Access type: Read-only
Qualifiers: Maxlen (64) , Mappingstrings ("MIF.DMTF|ComponentID|001.4")

Serial number of the software element.

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

Identifier for the software element. It is designed to be used in conjunction with other keys to create a unique representation of this CIM_SoftwareElement.

SoftwareElementState
Data type: uint16
Access type: Read-only
Qualifiers: key

State of a software element.

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.

 

Status
Data type: string
Access type: Read-only

Current status of the object. This property is inherited from CIM_ManagedSystemElement.

Values include the following:

"OK"
"Error"
"Degraded"
"Unknown"
"Pred Fail"
"Starting"
"Stopping"
"Service"
"Stressed"
"NonRecover"
"No Contact"
"Lost Comm"
TargetOperatingSystem
Data type: uint16
Access type: Read-only
Qualifiers: key, Mappingstrings ("MIF.DMTF|Software Component Information|002.5") , ModelCorrespondence ("CIM_OperatingSystem.OSType")

Operating system environment. The value of this property does not ensure binary executability, more information is needed. The operating system version must be specified using the operating system version check. Also needed, is the architecture on which the operating system runs. The combination of these constructs allows the provider to clearly identify the level of operating system required for a particular 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: 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

The CIM_SoftwareElement class is derived from CIM_LogicalElement.

WMI does not implement this class. For WMI classes derived from CIM_SoftwareElement, 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