DefineCollection method of the Msvm_CollectionManagementService class
Creates a new CIM_CollectionOfMSEs object.
Syntax
uint32 DefineCollection(
[in] string Name,
[in] string Id,
[in] uint16 Type,
[out] CIM_CollectionOfMSEs REF DefinedCollection,
[out] CIM_ConcreteJob REF Job
);
Parameters
-
Name [in]
-
A user defined name for the new collection. If a name is not specified, the default new collection name is used.
-
Id [in]
-
A GUID used to identify the group. The GUID must be unique, or the call will fail. If a GUID is not specified, the service generates one.
-
Type [in]
-
The type of collection object to create.
-
Collection of Virtual Systems (0)
-
Collection of Collections (1)
DefinedCollection [out]
A reference to the new collection.
Job [out]
A reference to the job for the operation. This parameter can be set to NULL if the job is complete.
Return value
The possible returns values are:
-
Completed with No Error (0)
-
Method Parameters Checked - Job Started (4096)
-
Failed (32768)
-
Access Denied (32769)
-
Not Supported (32770)
-
Status is unknown (32771)
-
Timeout (32772)
-
Invalid parameter (32773)
-
System is in use (32774)
-
Invalid state for this operation (32775)
-
Incorrect data type (32776)
-
System is not available (32777)
-
Out of memory (32778)
-
File not found (32779)
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2016 |
| Namespace |
Root\HyperVCluster\v2 |
| MOF |
|
| DLL |
|