LoginToTarget_IN structure (iscsiop.h)

Article
02/29/2024

La structure LoginToTarget_IN contient les données d’entrée de la méthode LoginToTarget , qui est utilisée pour se connecter à une cible.

Syntaxe

typedef struct _LoginToTarget_IN {
  ULONG               PortNumber;
  ISCSI_LoginOptions  LoginOptions;
  ULONG               SessionType;
  ULONGLONG           SecurityFlags;
  ISCSI_TargetPortal  TargetPortal;
  ULONG               UsernameSize;
  ULONG               PasswordSize;
  ULONG               KeySize;
  USHORT              UniqueIdForISID;
  BOOLEAN             PersistentLogin;
  WCHAR               InitiatorNode[223 + 1];
  WCHAR               InitiatorAlias[255 + 1];
  WCHAR               TargetName[223 + 1];
  ISCSI_TargetMapping Mappings;
  UCHAR               Key[1];
} LoginToTarget_IN, *PLoginToTarget_IN;

Membres

PortNumber

Numéro du port (portail initiateur) que l’initiateur HBA utilise pour établir la session d’ouverture de session. Cette valeur doit correspondre au membre Index de la structure ISCSI_PortalInfo .

LoginOptions

Structure ISCSI_LoginOptions qui spécifie les caractéristiques de la session d’ouverture de session.

SessionType

Valeur d’énumération LOGINSESSIONTYPE qui spécifie le type de session d’ouverture de session.

SecurityFlags

Ou au niveau du bit des indicateurs de sécurité qui indiquent les exigences de sécurité associées à la clé d’authentification utilisée pour établir la session d’ouverture de session. Pour obtenir la liste des indicateurs que vous pouvez combiner pour définir la valeur de ce membre, consultez SECURITY_FLAG_QUALIFIERS.

TargetPortal

Structure ISCSI_TargetPortal qui indique le portail cible à utiliser pour établir la connexion.

UsernameSize

Taille, en octets, de la chaîne dans Nom d’utilisateur.

PasswordSize

Taille, en octets, de la chaîne dans Mot de passe.

KeySize

Taille, en octets, de la chaîne dans Key.

UniqueIdForISID

Nombre que le pilote miniport qui gère l’adaptateur HBA peut utiliser pour construire un identificateur de session unique (ISID).

PersistentLogin

Valeur booléenne qui indique si l’ouverture de session doit être persistante. Si ce membre a la valeur TRUE, l’ouverture de session doit être persistante. Le pilote miniport du HBA doit stocker les caractéristiques de cette ouverture de session dans la mémoire non volatile et se connecter automatiquement à la cible chaque fois que le système d’exploitation charge le pilote miniport. Si ce membre a la valeur FALSE, l’ouverture de session n’est pas persistante.

InitiatorNode[223 + 1]

Nom iSCSI du nœud initiateur à utiliser pour la connexion. Si ce membre est vide, le pilote miniport de l’adaptateur HBA peut choisir n’importe quel nom de nœud initiateur lors de l’authentification. Le nom du nœud initiateur est généralement un nom qualifié iSCSI (IQN).

InitiatorAlias[255 + 1]

Alias iSCSI du nœud initiateur.

TargetName[223 + 1]

Nom de la cible iSCSI avec lequel établir la session d’ouverture de session.

Mappings

Structure ISCSI_TargetMapping qui mappe une collection de numéros d’unité logique (LUN) définis localement à un groupe de numéros d’unité logique iSCSI 64 bits. Si le service initiateur ne spécifie pas de mappages, le pilote miniport du HBA peut utiliser des mappages pour les lun. Le pilote miniport doit signaler les numéros logiques non mappés au pilote de port à énumérer.

Key[1]

Tableau de longueur variable de valeurs UCHAR qui définit la clé prépartagée associée à l’adresse IP cible.