Share via

AddConnection method of the MSIscsiInitiator_SessionClass class

  • Article

The AddConnection method adds a new connection to the specified session.

Syntax

uint32 AddConnection(
  [in]  uint32                              InitiatorPortNumber,
  [in]  MSIscsiInitiator_Portal             TargetPortal,
  [in]  ISCSI_SECURITY_FLAGS                SecurityFlags,
  [in]  MSIscsiInitiator_TargetLoginOptions LoginOptions,
  [in]  uint8                               Key[],
  [out] string                              UniqueConnectionId
);

Parameters

InitiatorPortNumber [in]

The port number associated with the Initiator.

TargetPortal [in]

An MSIscsiInitiator_Portal structure that contains information about the Target Portal.

SecurityFlags [in]

A bitmap that defines the security characteristics of a login connection.

Value Meaning
ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED
 The Host Bus Adapter (HBA) initiator should establish the TCP/IP connection to the target portal using IPsec tunnel mode.
ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED
 The HBA initiator should establish the TCP/IP connection to the target portal using IPsec transport mode.
ISCSI_SECURITY_FLAG_PFS_ENABLED
 The HBA initiator should establish the TCP/IP connection to the target portal with Perfect Forward Secrecy (PFS) mode enabled if IPsec is required.
ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED
 The HBA initiator should establish the TCP/IP connection to the target portal with aggressive mode enabled.
ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED
 The HBA initiator should establish the TCP/IP connection to the target portal with main mode enabled.
ISCSI_SECURITY_FLAG_IKE_IPSEC_ENABLED
 The HBA initiator should establish the TCP/IP connection to the target portal using IKE/IPsec protocol. If not set then IPsec is not required to login to the target.
ISCSI_SECURITY_FLAG_VALID
 The other mask values are valid; otherwise, security flags are not specified.

LoginOptions [in]

An MSIscsiInitiator_TargetLoginOptions structure that specifies the characteristics of the login session.

Key [in]

The key used for authentication.

UniqueConnectionId [out]

The unique ID associated with the new connection.

Requirements
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2008 [desktop apps only]
Namespace
 Root\WMI
MOF
Iscsidsc.mof

See also

MSIscsiInitiator_SessionClass