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
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.
