CreatePool method of the Msvm_ResourcePoolConfigurationService class

Creates a child resource pool. The resource pool will be scoped to the same System as this Service. The resulting pool will be a child pool.

Syntax

uint32 CreatePool(
  [in]  string               PoolSettings,
  [in]  CIM_ResourcePool REF ParentPools[],
  [in]  string               AllocationSettings[],
  [out] CIM_ResourcePool REF Pool,
  [out] CIM_ConcreteJob  REF Job
);

Parameters

PoolSettings [in]

An embedded instance of the Msvm_ResourcePoolSettingData class that is used to specify the pool settings that are not allocation related.

ParentPools [in]

An array of Msvm_ResourcePool references that represent the pool or pools from which to create the new pool.

AllocationSettings [in]

An array of one or more embedded instances of the Msvm_ResourceAllocationSettingData class that are used to specify the pool allocation related settings. This array must contain either one element for each element in the ParentPools array, or exactly one element. If this array contains one element and ParentPools contains more than one element, AlllocationSettings specifies a shared capacity allocation that can be satisfied by any of the parent pools.

This is used to restrict the resources that can be allocated from the child to the pool to a lower limit than the aggregate capacity provided by its parents. This option is not supported by all resource types. If a resource type does not support shared capacity allocation, this method will return 32770 (Not Supported).

Pool [out]

A reference to the resulting pool.

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.

Job Completed with No Error (0)

DMTF Reserved (..)

Method Parameters Checked - Job Started (4096)

Method Reserved (4097..32767)

Failed (32768)

Access Denied (32769)

Not Supported (32770)

Unknown (32771)

Timeout (32772)

Invalid Parameter (32773)

In Use (32774)

Invalid State (32775)

Incorrect Resource Type for the Pool (32776)

Unavailable (32777)

Out of Memory (32778)

Vendor Reserved (32779)

Insufficient Resources (32780)

Object Not Found (32781..32787)

Object Exists (32788)

Vendor Specific (32768..65535)

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

See also

Msvm_ResourcePoolConfigurationService