This topic has not yet been rated - Rate this topic

AddInitiatorId method of the MSFT_MaskingSet class

Adds one or more initiator identifiers to the masking set.

All virtual disks in the masking set will be accessible (shown) to these initiators.

Syntax


UInt32 AddInitiatorId(
  [in]   String InitiatorIds[],
  [in]   UInt16 HostType,
  [out]  String ExtendedStatus
);

Parameters

InitiatorIds [in]

Array of strings containing initiator addresses. For each address contained in this array, a corresponding MSFT_InitiatorId instance should be created and then associated with this masking set using the MSFT_MaskingSetToInitiatorId class.

This parameter is required and cannot be NULL.

HostType [in]

The host operating system or other host environmental factors that may influence the behavior that the storage system should have when showing a virtual disk to an initiator.

Unknown (0)
Standard (2)
Solaris (3)
HPUX (4)
OpenVMS (5)
Tru64 (6)
Netware (7)
Sequent (8)
AIX (9)
DGUX (10)
Dynix (11)
Irix (12)
Cisco iSCSI Storage Router (13)
Linux (14)
Microsoft Windows (15)
OS400 (16)
TRESPASS (17)
HI-UX (18)
VMware ESXi (19)
Microsoft Windows Server 2008 (20)
Microsoft Windows Server 2003 (21)
Microsoft Reserved (22..32767)
Vendor Specific (32768..65535)

ExtendedStatus [out]

A string that contains an embedded MSFT_StorageExtendedStatus object.

This parameter allows the storage provider to return extended (implementation-specific) error information.

Return value

Success (0)
Not Supported (1)
Unspecified Error (2)
Timeout (3)
Failed (4)
Invalid Parameter (5)
Access denied (40001)
There are not enough resources to complete the operation. (40002)
Cannot connect to the storage provider. (46000)
The storage provider cannot connect to the storage subsystem. (46001)
The initiator address specified is not valid (53000)
Only one initiator address is acceptable for this operation. (53001)

Requirements

Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Namespace	\\.\Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof (for application developers); Storagewmi_provider.mof (for provider developers)

Community Additions