ModifySystemSettings method of the Msvm_VirtualSystemManagementService class

Modifies virtual machine settings. When applied to the system settings of a "current" virtual machine configuration, as a side effect the virtual machine instance may be modified.

Syntax

uint32 ModifySystemSettings(
  [in]  string              SystemSettings,
  [out] CIM_ConcreteJob REF Job
);

Parameters

SystemSettings [in]

An embedded instance of the Msvm_VirtualSystemSettingData class that contains the modified aspects of the virtual machine. The InstanceID property identifies the virtual machine setting to be modified.

Job [out]

If the operation is performed asynchronously, this method will return 4096, and this parameter will contain a reference to an object derived from CIM_ConcreteJob.

Return value

This method returns one of the following values.

Completed with No Error (0)

Not Supported (1)

Failed (2)

Timeout (3)

Invalid Parameter (4)

Invalid State (5)

Incompatible Parameters (6)

DMTF Reserved (..)

Method Parameters Checked - Job Started (4096)

Method Reserved (4097..32767)

Vendor Specific (32768..65535)

Requirements

Requirement Value
Minimum supported client
Windows 8 [desktop apps only]
Minimum supported server
Windows Server 2012 [desktop apps only]
Namespace
Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

See also

ModifyVirtualSystem (V1)

Msvm_VirtualSystemManagementService