structure AddConnectionToSession_IN (iscsiop.h)

Article
02/29/2024

La structure AddConnectionToSession_IN contient des données d’entrée pour la méthode AddConnectionToSession , qui est 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 une carte et un instance chargé particulier d’un pilote miniport de stockage qui gère l’adaptateur. Cet identificateur est unique, non seulement sur l’ordinateur où se trouve l’adaptateur, mais également sur l’ensemble du réseau.

UniqueSessionId

Entier 64 bits qui identifie de manière unique la session. Les méthodes LoginToTarget et AddConnectionToSession retournent toutes deux 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

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

TargetPortal

Une structure ISCSI_TargetPortal qui indique le portail cible à utiliser pour créer la connexion supplémentaire. La méthode AddConnectionToSession appelle la méthode LoginToTarget pour établir la nouvelle connexion. Si LoginToTarget échoue avec une valeur status ISCSC_TARGET_MOVED_PERMANENTLY ou ISCSC_TARGET_MOVED_TEMPORARILY. TargetPortal indique, lors de la sortie de AddConnectionToSession, le portail vers lequel l’opération d’ouverture de session doit être redirigée. Pour plus d’informations sur les valeurs ISCSC_TARGET_MOVED_PERMANENTLY et ISCSC_TARGET_MOVED_TEMPORARILY status, 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 dans le tableau est spécifié par le champ KeySize.