CreateiSCSIProtocolEndpoint method of the MSISCSITARGET_iSCSIConfigurationService class
Creates an iSCSI port in the form of an MSISCSITARGET_iSCSIProtocolEndpoint instance.
This method is inherited from the CIM_iSCSIConfigurationService class.
Syntax
uint32 CreateiSCSIProtocolEndpoint(
[in] CIM_SCSIProtocolController Ref iSCSINode,
[in] uint16 Role,
[in, optional] string Identifier,
[in] CIM_ProtocolEndpoint Ref NetworkPortals[],
[out] CIM_iSCSIProtocolEndpoint Ref iSCSIPort
);
Parameters
-
iSCSINode [in]
-
Specifies the iSCSI node that will contain the iSCSI port.
-
Role [in]
-
Specifies whether the new CIM_iSCSIProtocolEndpoint instance acts as a target or an initiator endpoint.
The possible values are.
-
Initiator (2)
-
Target (3)
Identifier [in, optional]
Specifies the Identifier property of the new CIM_iSCSIProtocolEndpoint instance in the form of 12 hexadecimal digits. The Identifier for an initiator port is the initiator-side identifier (ISID) of the port. The Identifier for a target port is the Target Portal Group Tag (TGPT) of the port.
Each MSISCSITARGET_iSCSIProtocolEndpoint instance that is associated to a common CIM_SCSIProtocolController instance must have a unique Identifier.
Note
If the MSISCSITARGET_iSCSIConfigurationCapabilities.IdentifierSelectionSupported property is false, this parameter must be set to NULL.
NetworkPortals [in]
Specifies either CIM_TCPProtocolEndpoint instances that represent target network portals or CIM_IPProtocolEndpoint instances that represent initiator network portals. If CIM_TCPProtocolEndpoint instances are supplied, each must be associated to a CIM_IPProtocolEndpoint instance through a CIM_BindsTo association to provide the target network portal functionality. The selected portal endpoints must be from the same system specific collection, which represents a portal group.
iSCSIPort [out]
On return, contains a reference to the new MSISCSITARGET_iSCSIProtocolEndpoint instance.
The new MSISCSITARGET_iSCSIProtocolEndpoint instance is associated with the specified underlying instances of TCP/IP protocol endpoints by using CIM_BindsTo instances. In addition, a MSISCSITARGET_SAPAvailableForElement instance is created that associates the specified CIM_SCSIProtocolController and the new MSISCSITARGET_iSCSIProtocolEndpoint instance.
Return value
This method returns one of the following values.
-
Success (0)
-
Not Supported (1)
-
Unspecified Error (2)
-
Timeout (3)
-
Failed (4)
-
Invalid Parameter (5)
-
DMTF Reserved (6 4095)
-
SCSIProtocolController Non-existent (4096)
-
Role Not Supported By Specified SCSIProtocolController (4097)
-
Identifier In Use, Not Unique (4098)
-
Identifier Selection Not Supported (4099)
-
ProtocolEndpoint Non-Existent (4100)
-
TCPProtocolEndpoint Not Bound To Underlying IPProtocolEndpoint (4101)
-
TCPProtocolEndpoint In Use By Other iSCSIProtocolEndpoint In Same Target SCSIProtocolController (4102)
-
ProtocolEndpoints Not From Same Endpoint Collection (4103)
-
Method Reserved (4100 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 |
|