CreateVirtualSystemConfiguration method of the CIM_VirtualSystemManagementService class

Create a validated virtual system configuration at the virtualization platform. The configuration may be used in a subsequent call to DefineVirtualSystem to actually create the virtual system.

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 CreateVirtualSystemConfiguration(
  [in]  string                 SystemSettingData,
  [in]  string                 ResourceSettingData[],
  [out] CIM_ComputerSystem REF StoredConfiguration,
  [out] CIM_ConcreteJob REF    Job
);

Parameters

  • SystemSettingData [in]
    String containing a instance of CIM_VirtualSystemSettingData that is used to define attributes of the Virtual System to be created.

  • ResourceSettingData [in]
    Array of strings containing instance of CIM_ResourceAllocationSettingData that describe virtual aspects of virtual resources to be created in the scope of the new Virtual System.

  • StoredConfiguration [out]
    Reference to created virtual system configuration.

  • 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)

DMTF Reserved (..)

Method Parameters Checked - Job Started (4096)

Method Reserved (4097..32767)

Vendor Specific (32768..65535)

Requirements

Namespace

Root\CIMV2

See also

CIM_VirtualSystemManagementService