Partager via

CloneVirtualSystem method of the CIM_VirtualSystemManagementService class

  • Article

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