The CIM_SettingCheck class specifies information needed to check a particular setting file for a specific entry that contains a value equal to the value specified. All comparisons are assumed to be case insensitive.
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
[UUID("{DC1D8140-DB30-11d2-85FC-0000F8102E5F}"), Abstract, AMENDMENT]
class CIM_SettingCheck : CIM_Check
{
string Caption;
string CheckID;
boolean CheckMode;
uint16 CheckType;
string Description;
string EntryName;
string EntryValue;
string FileName;
string Name;
string SectionKey;
string SoftwareElementID;
uint16 SoftwareElementState;
uint16 TargetOperatingSystem;
string Version;
};
Members
The CIM_SettingCheck class has these types of members:
Methods
The CIM_SettingCheck class has these methods.
| Method | Description |
|---|---|
| Invoke | Takes a particular action. Not implemented by WMI. |
Properties
The CIM_SettingCheck 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_Check.
CheckID
Data type: string
Access type: Read-only
Identifier 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.
CheckType
Data type: uint16
Access type: Read-only
Way in which the setting value should be compared.
Matches (0)
Contains (1)
Description
Data type: string
Access type: Read-only
Description of the object.
This property is inherited from CIM_Check.
EntryName
Data type: string
Access type: Read-only
Qualifiers: Maxlen (256)
Name of the entry to be checked
EntryValue
Data type: string
Access type: Read-only
Value that is associated with the named entry to check.
FileName
Data type: string
Access type: Read-only
Qualifiers: Maxlen (1024)
File name of the setting file to check.
Name
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.Name"), CIM_key, maxlen (256)
Name used to identify the software element. This property is inherited from CIM_Check.
SectionKey
Data type: string
Access type: Read-only
Qualifiers: Maxlen (256)
Key of section that contains the settings to check.
SoftwareElementID
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.SoftwareElementID"), CIM_key, maxlen (256)
Identifier for the software element.
This property is inherited from CIM_Check.
SoftwareElementState
Data type: uint16
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.SoftwareElementState"), CIM_key
State of a software element.
This property is inherited from CIM_Check.
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.
This property is inherited from CIM_Check.
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>
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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Namespace | Root\CIMV2 |
| MOF | CIMWin32.mof |
| DLL | CIMWin32.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
