structure AddConnectionToSession_IN (iscsiop.h)

Article
02/07/2025

La structure AddConnectionToSession_IN contient des données d’entrée pour la méthode AddConnectionToSession, utilisée pour ajouter une nouvelle connexion à une session déjà existante.

Syntaxe

typedef struct _AddConnectionToSession_IN {
  ULONGLONG          UniqueAdapterId;
  ULONGLONG          UniqueSessionId;
  ULONGLONG          SecurityFlags;
  ULONG              PortNumber;
  ISCSI_LoginOptions LoginOptions;
  ISCSI_TargetPortal TargetPortal;
  ULONG              UsernameSize;
  ULONG              PasswordSize;
  ULONG              KeySize;
  UCHAR              Key[1];
} AddConnectionToSession_IN, *PAddConnectionToSession_IN;

Membres

UniqueAdapterId

Entier 64 bits qui identifie de manière unique un adaptateur et une instance chargée particulière d’un pilote miniport de stockage qui gère l’adaptateur. Cet identificateur est unique, non seulement sur l’ordinateur où se trouve la carte, mais également sur l’ensemble du réseau.

UniqueSessionId

Entier 64 bits qui identifie de façon unique la session. Les méthodes LoginToTarget et AddConnectionToSession retournent cette valeur dans leur paramètre UniqueSessionId. Ne confondez pas cette valeur avec les valeurs des membres ISID et TSID.

SecurityFlags

Or au niveau du bit des indicateurs qui indiquent les exigences de sécurité d’une cible. Pour obtenir la liste des valeurs possibles pour ce membre, consultez SECURITY_FLAG_QUALIFIERS.

PortNumber

Numéro du port à partir duquel lancer la session d’ouverture de session cible.

LoginOptions

Structure ISCSI_LoginOptions qui décrit les caractéristiques de la session d’ouverture de session cible à laquelle une connexion sera ajoutée.

TargetPortal

Structure ISCSI_TargetPortal qui indique le portail cible à utiliser pour établir la connexion supplémentaire. La méthode AddConnectionToSession appelle la méthode LoginToTarget pour établir la nouvelle connexion. Si LoginToTarget échoue avec une valeur d’état de ISCSC_TARGET_MOVED_PERMANENTLY ou de ISCSC_TARGET_MOVED_TEMPORARILY. TargetPortal indique, à partir de addConnectionToSession, le portail vers lequel l’opération d’ouverture de session doit être redirigée. Pour plus d’informations sur les valeurs d’état ISCSC_TARGET_MOVED_PERMANENTLY et de ISCSC_TARGET_MOVED_TEMPORARILY, consultez ISCSI_STATUS_QUALIFIERS.

UsernameSize

Taille du nom d’utilisateur, en octets.

PasswordSize

Taille du mot de passe, en octets.

KeySize

Taille de clé prépartagée, en octets.

Key[1]

Tableau de caractères de longueur variable qui spécifie la clé prépartagée associée à l’adresse IP cible. Le nombre d’éléments du tableau est spécifié par le champ KeySize.