CloneVirtualSystem method of the CIM_VirtualSystemManagementService class

Optional method to clone a virtual system. An implementation implementing the CloneVirtualSystem() method shall set the CloneVirtualSystemSupported flag of its CIM_VirtualSystemManagementCapabilities instance. CloneVirtualSystem() shall allow to apply modifications to the cloned system in the same way as ModifyVirtualSystem(). The implementation may decide whether these modifications are applied during the clone process or after an initially identical cloned system was created. If the CopyContent flag is set, then the source virtual system must be in the 'Defined' state for the duration of the method execution.

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.

Syntax


uint32 CloneVirtualSystem(
  [in]   CIM_ComputerSystem REF SourceSystem,
  [in]   CIM_VirtualSystemSettingData SourceInstance,
  [out]  CIM_ComputerSystem REF ClonedSystem,
  [out]  CIM_ConcreteJob REF Job
);

Parameters

SourceSystem [in]

Reference to instance of CIM_ComputerSystem representing a virtual computer system to be modified.

SourceInstance [in]

Reference to the instance of the computer system settings which should be the source of the clone.

ClonedSystem [out]

Reference to ComputerSystem (if one is created)

Job [out]

If operation is long running then optionally a job may be returned

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

Namespace

\root\CIMV2

See also

CIM_VirtualSystemManagementService

 

 

Show:
© 2014 Microsoft