Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |
|