AddGuestServiceSettings method of the Msvm_VirtualSystemManagementService class

Adds guest service settings to a virtual system configuration.

When applied to parts of a "current" virtual system configuration, as a side effect guest services of the active virtual system may be modified.

Syntax

uint32 AddGuestServiceSettings(
  [in]  CIM_VirtualSystemSettingData REF AffectedConfiguration,
  [in]  string                           GuestServiceSettings[],
  [out] CIM_SettingData              REF ResultingGuestServiceSettings[],
  [out] CIM_ConcreteJob              REF Job
);

Parameters

AffectedConfiguration [in]

Reference to a CIM_VirtualSystemSettingData that describes the affected configuration.

GuestServiceSettings [in]

An array containing the guest service settings.

ResultingGuestServiceSettings [out]

On success, contains a reference to a CIM_SettingData that describes the resulting guest service settings.

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)

DMTF Reserved (..)

Method Parameters Checked - Job Started (4096)

Method Reserved (4097..32767)

Vendor Specific (32768..65535)

Requirements

Requirement Value
Minimum supported client
Windows 10 [desktop apps only]
Minimum supported server
Windows Server 2016
Namespace
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

See also

Msvm_VirtualSystemManagementService