CreateResourcePool method of the CIM_ResourcePoolConfigurationService class
Starts a job to create a root ResourcePool. The ResourcePool will be scoped to the same System as this Service.
Syntax
uint32 CreateResourcePool(
[in] string ElementName,
[in] CIM_LogicalDevice REF HostResources[],
[in] string ResourceType,
[out] CIM_ResourcePool REF Pool,
[out] CIM_ConcreteJob REF Job
);
Parameters
-
ElementName [in]
-
A end user relevant name for the pool being created. If NULL, then a system supplied default name can be used. The value will be stored in the ElementName property for the created pool.
-
HostResources [in]
-
Array of zero or more CIM_LogicalDevice devices that are used to create the Pool or modify the source extents. All elements in the array must be of the same type.
-
ResourceType [in]
-
The type of resources the created pool will manage. If HostResources contains elements, this property must mach their type.
-
Pool [out]
-
On success, returns a reference to the resulting CIM_ResourcePool. When a Job is returned, this may be NULL, in which case, the client must use the Job to find the resulting ResourcePool once the Job completes.
-
Job [out]
-
Reference to a CIM_ConcreteJob that represents the job (may be null if job completed).
Return value
Returns a 0 on success; otherwise, returns an error.
-
Job Completed with No Error (0)
-
Not Supported (1)
-
Unknown (2)
-
Timeout (3)
-
Failed (4)
-
Invalid Parameter (5)
-
In Use (6)
-
Incorrect ResourceType for the Pool (7)
-
DMTF Reserved (..)
-
Method Parameters Checked - Job Started (4096)
-
Size Not Supported (4097)
-
Method Reserved (4098..32767)
-
Vendor Specific (32768..65535)
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 8.1 |
| Minimum supported server |
Windows Server 2012 R2 |
| Namespace |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|