ISCSI_TARGET_PORTAL_INFO_EX structure

The ISCSI_TARGET_PORTAL_INFO_EX structure contains information about login credentials to a target portal.

Syntax


typedef struct _ISCSI_TARGET_PORTAL_INFO_EX {
  WCHAR                InitiatorName[MAX_ISCSI_HBANAME_LEN];
  ULONG                InitiatorPortNumber;
  WCHAR                SymbolicName[MAX_ISCSI_PORTAL_NAME_LEN];
  WCHAR                Address[MAX_ISCSI_PORTAL_ADDRESS_LEN];
  USHORT               Socket;
  ISCSI_SECURITY_FLAGS SecurityFlags;
  ISCSI_LOGIN_OPTIONS  LoginOptions;
} ISCSI_TARGET_PORTAL_INFO_EX, *PISCSI_TARGET_PORTAL_INFO_EX;

Members

InitiatorName

A string that represents the name of the Host-Bus Adapter (HBA) initiator.

InitiatorPortNumber

A ULONG value that represents the port number on the HBA associated with the portal.

SymbolicName

A string that represents the symbolic name associated with the portal.

Address

A string that represents the IP address or DNS name associated with the portal.

Socket

A USHORT value that represents the socket number.

SecurityFlags

A pointer to an ISCSI_SECURITY_FLAGS structure that contains a bitmap that defines the security charactaristics of a login connection.

ValueMeaning
ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED

When set to 1, the initiator should make the connection in IPsec tunnel mode. Caller should set this flag or the ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED flag, but not both.

ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED

When set to 1, the initiator should make the connection in IPsec transport mode. Caller should set this flag or the ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED flag, but not both.

ISCSI_SECURITY_FLAG_PFS_ENABLED

When set to 1, the initiator should make the connection with Perfect Forward Secrecy (PFS) mode enabled; otherwise, the initiator should make the connection with PFS mode disabled.

ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED

When set to 1, the initiator should make the connection with aggressive mode enabled. Caller should set this flag or the ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED flag, but not both.

Note  The Microsoft software initiator driver does not support aggressive mode.
 
ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED

When set to 1, the initiator should make the connection with main mode enabled. Caller should set this flag or the ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED flag, but not both.

ISCSI_SECURITY_FLAG_IKE_IPSEC_ENABLED

When set to 1, the initiator should make the connection with the IKE/IPsec protocol enabled; otherwise, the IKE/IPsec protocol is disabled.

ISCSI_SECURITY_FLAG_VALID

When set to 1, the other mask values are valid; otherwise, the iSCSI initiator service will use bitmap values that were previously defined for the target portal, or if none are available, the initiator service uses the default values defined in the registry.

 

LoginOptions

A pointer to an ISCSI_LOGIN_OPTIONS structure that defines the login data.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Iscsidsc.h

Unicode and ANSI names

ISCSI_TARGET_PORTAL_INFO_EXW (Unicode) and ISCSI_TARGET_PORTAL_INFO_EXA (ANSI)

See also

ISCSI_TARGET_PORTAL_INFO

 

 

Community Additions

ADD
Show: