CreateHardwareIDCollection method of the CIM_StorageHardwareIDManagementService class
Create a group of StorageHardwareIDs as a new instance of SystemSpecificCollection. This is useful to define a set of authorized subjects that can access volumes in a disk array. This method allows the client to make a request of a specific Service instance to create the collection and provide the appropriate class name. When these capabilities are standardized in CIM/WBEM, this method can be deprecated and intrinsic methods used. In addition to creating the collection, this method causes the creation of the HostedCollection association (to this service's scoping system) and MemberOfCollection association to members of the IDs parameter.
Syntax
uint32 CreateHardwareIDCollection(
[in] string ElementName,
[in] string HardwareIDs[],
[out] CIM_SystemSpecificCollection REF Collection
);
Parameters
-
ElementName [in]
-
The ElementName to be assigned to the created collection.
-
HardwareIDs [in]
-
Array of strings containing representations of references to StorageHardwareID instances that will become members of the new collection.
-
Collection [out]
-
The new instance of SystemSpecificCollection that is created.
Return value
-
Success (0)
-
Not Supported (1)
-
Unspecified Error (2)
-
Timeout (3)
-
Failed (4)
-
Invalid Parameter (5)
-
DMTF Reserved (6 4095)
-
Invalid HardwareID instance (4096)
-
Implementation does not support hardware ID collections (4097)
-
Input hardware IDs cannot be used in same collection (4098)
-
Method Reserved (4099 32767)
-
Vendor Specific (32768 65535)
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2012 R2 |
| Namespace |
Root\CIMv2\Storage\iScsiTarget |
| MOF |
|
| DLL |
|