MSIscsiInitiator_PersistentLoginClass class

This MSIscsiInitiator_PersistentLoginClass structure defines a persistent logon that the operating system initiates automatically when the computer boots up.

Syntax

class MSIscsiInitiator_PersistentLoginClass
{
  string                              TargetName;
  boolean                             IsInformationalSession;
  string                              InitiatorInstance;
  uint32                              InitiatorPortNumber;
  MSIscsiInitiator_Portal             TargetPortal;
  ISCSI_SECURITY_FLAGS                SecurityFlags;
  MSiSCSIInitiator_TargetMappings     Mappings;
  MSIscsiInitiator_TargetLoginOptions LoginOptions;
};

Members

The MSIscsiInitiator_PersistentLoginClass class has these types of members:

Properties

The MSIscsiInitiator_PersistentLoginClass class has these properties.

InitiatorInstance

Data type: string

Access type: Read-only

A string representing the name of the initiator used to login to the target.

InitiatorPortNumber

Data type: uint32

Access type: Read-only

The port number of the Host-Bus Adapter (HBA) through which the session login is established.

IsInformationalSession

Data type: boolean

Access type: Read-only

A Boolean value that indicates whether the persistent logon is configured to establish a purely informational session. If this member is TRUE, the persistent logon is configured to establish a purely informational session.

A management application can still access targets not enumerated by the system via the SendScsiInquiry, SendScsiReportLuns, and SendScsiReadCapcity functions.

LoginOptions

Data type: MSIscsiInitiator_TargetLoginOptions

Access type: Read-only

An array of MSIscsiInitiator_TargetLoginOptions structures containing information about target login options.

Mappings

Data type: MSiSCSIInitiator_TargetMappings

Access type: Read-only

An array of MSIscsiInitiator_TargetMappings structures containing information about LUN mapping.

SecurityFlags

Data type: ISCSI_SECURITY_FLAGS

Access type: Read-only

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.

 

TargetName

Data type: string

Access type: Read-only

Qualifiers: Key

A wide character string that indicates the name of the target with which the iSCSI initiator service establishes a persistent logon when it restarts.

TargetPortal

Data type: MSIscsiInitiator_Portal

Access type: Read-only

An array of MSIscsiInitiator_Portal structures containing information about iSCSI initiator portals.

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_Portal

MSIscsiInitiator_TargetMappings

MSIscsiInitiator_TargetLoginOptions