ModifyResourceSettings method of the Msvm_VirtualSystemManagementService class

Modifies virtual resource settings. When applied to parts of a current virtual machine configuration, as a side effect, the resources of the active virtual machine may be modified.

Syntax

uint32 ModifyResourceSettings(
  [in]  string                                ResourceSettings[],
  [out] CIM_ResourceAllocationSettingData REF ResultingResourceSettings[],
  [out] CIM_ConcreteJob                   REF Job
);

Parameters

ResourceSettings [in]

An array of strings that contain an embedded instance of a class derived from CIM_ResourceAllocationSettingData, that contain the modified aspects of existing virtual resources. The InstanceID property of each instance identifies the virtual resource setting to be modified.

ResultingResourceSettings [out]

An array of references to instances of objects derived from CIM_ResourceAllocationSettingData representing virtual aspects of the modified virtual resources.

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

ModifyVirtualSystemResources (V1)

Msvm_VirtualSystemManagementService