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

See also

CIM_StorageHardwareIDManagementService