The CIM_ModifySettingAction class represents the information for modifying a specific setting file, for a specific entry, with a specific value.
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("{ECDE0B90-DB2A-11d2-85FC-0000F8102E5F}"), Abstract, AMENDMENT]
class CIM_ModifySettingAction : CIM_Action
{
string ActionID;
string Caption;
string Description;
uint16 Direction;
string Name;
string SoftwareElementID;
uint16 SoftwareElementState;
uint16 TargetOperatingSystem;
string Version;
uint16 ActionType;
string EntryName;
string EntryValue;
string FileName;
string SectionKey;
};
Members
The CIM_ModifySettingAction class has these types of members:
Methods
The CIM_ModifySettingAction class has these methods.
| Method | Description |
|---|---|
| Invoke | Takes a specific action. Not implemented by WMI. |
Properties
The CIM_ModifySettingAction class has these properties.
ActionID
Data type: string
Access type: Read-only
Unique identifier assigned to a particular action for a software element.
This property is inherited from CIM_Action.
ActionType
Data type: uint16
Access type: Read-only
Type of action to perform on the specified setting entry. Additions are assumed to be case sensitive; however, removals are assumed to be case insensitive.
Create (0)
Creates the specified entry.
Delete (1)
Deletes the specified entry.
Append (2)
Appends to the end of the specified entry.
Remove (3)
Removes the value from the specified entry.
Caption
Data type: string
Access type: Read-only
Qualifiers: maxlen (64)
Short textual description of the object.
This property is inherited from CIM_Action.
Description
Data type: string
Access type: Read-only
Description of the object.
This property is inherited from CIM_Action.
Direction
Data type: uint16
Access type: Read-only
Indicates whether a particular CIM_Action object is part of a sequence of actions to transition the current software element to its next state, such as "Install", or to remove the current software element, such as "Uninstall".
This property is inherited from CIM_Action.
Install (0)
Uninstall (1)
EntryName
Data type: string
Access type: Read-only
Qualifiers: Maxlen (256)
Name of the entry to modify.
EntryValue
Data type: string
Access type: Read-only
Value to add, append, or to replace the specified setting.
FileName
Data type: string
Access type: Read-only
Qualifiers: Maxlen (1024)
File name of the setting file entry to modify.
Name
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.Name"), CIM_key, maxlen (256)
Identifies the software element.
This property is inherited from CIM_Action.
SectionKey
Data type: string
Access type: Read-only
Qualifiers: Maxlen (256)
Section key of the setting entry to modify.
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_Action.
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_Action.
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 owning software element.
This property is inherited from CIM_Action.
Unknown (0)
Other (1)
MACOS (2)
Mac OS
ATTUNIX (3)
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)
Be OS
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 CIM_Action.
Remarks
The CIM_ModifySettingAction class is derived from CIM_Action.
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.
