CIM_SoftwareElement class (CIMWin32 WMI Providers)
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
-
Qualifiers: MaxLen (64), DisplayName ("Caption")
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
-
Qualifiers: DisplayName ("Description")
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
-
Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Install Date")
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
-
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
-
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.
-
-
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.
Status
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (10), DisplayName ("Status")
Current status of the object.
This property is inherited from CIM_ManagedSystemElement.
Values include the following:
OK ("OK")
Error ("Error")
Degraded ("Degraded")
Unknown ("Unknown")
Pred Fail ("Pred Fail")
Starting ("Starting")
Stopping ("Stopping")
Service ("Service")
Stressed ("Stressed")
NonRecover ("NonRecover")
No Contact ("No Contact")
Lost Comm ("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.
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
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|