CreateStorageHardwareID method of the CIM_StorageHardwareIDManagementService class

This method creates a CIM_StorageHardwareID, it creates the association CIM_ConcreteDependency between this service and the new CIM_StorageHardwareID.

Syntax

uint32 CreateStorageHardwareID(
  [in]  string                           ElementName,
  [in]  string                           StorageID,
  [in]  uint16                           IDType,
  [in]  string                           OtherIDType,
  [in]  CIM_StorageClientSettingData REF Setting,
  [out] CIM_StorageHardwareID        REF HardwareID
);

Parameters

ElementName [in]

The ElementName of the new StorageHardwareID instance.

StorageID [in]

StorageID is the value used by the SecurityService to represent Identity - in this case, a hardware worldwide unique name.

IDType [in]

The type of the StorageID property. iSCSI IDs may use one of three iSCSI formats - iqn, eui, or naa. This three letter format is the name prefix; so a single iSCSI type is provided here, the prefix can be used to further refine the format.

Other (1)

PortWWN (2)

NodeWWN (3)

Hostname (4)

iSCSI Name (5)

OtherIDType [in]

The type of the storage ID, when IDType is "Other".

Setting [in]

REF to the StorageClientSettingData containing the OSType appropriate for this initiator. If left NULL, the instrumentation assumes a standard OSType - i.e., that no OS-specific behavior for this initiator is defined.

HardwareID [out]

REF to the new StorageHardwareID instance.

Return value

Success (0)

Not Supported (1)

Unspecified Error (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

DMTF Reserved (6 4095)

ID already created (4096)

Hardware implementation does not support specified IDType (4097)

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	SmIscsiTarget.mof
DLL	SMiSCSITargetProv.dll

See also

CIM_StorageHardwareIDManagementService