ISCSI_SessionStaticInfo structure (iscsimgt.h)
La structure ISCSI_SessionStaticInfo fournit des informations sur les caractéristiques d’une session iSCSI.
Syntaxe
typedef struct _ISCSI_SessionStaticInfo {
ULONGLONG UniqueSessionId;
WCHAR InitiatoriSCSIName[223 + 1];
WCHAR TargetiSCSIName[223 + 1];
USHORT TSID;
UCHAR ISID[6];
BOOLEAN InitialR2t;
BOOLEAN ImmediateData;
UCHAR Type;
BOOLEAN DataSequenceInOrder;
BOOLEAN DataPduInOrder;
UCHAR ErrorRecoveryLevel;
ULONG MaxOutstandingR2t;
ULONG FirstBurstLength;
ULONG MaxBurstLength;
ULONG MaxConnections;
USHORT ConnectionCount;
ISCSI_ConnectionStaticInfo ConnectionsList[1];
} ISCSI_SessionStaticInfo, *PISCSI_SessionStaticInfo;
Membres
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 .
InitiatoriSCSIName[223 + 1]
Chaîne de caractères large qui spécifie le nom du nœud initiateur.
TargetiSCSIName[223 + 1]
Chaîne de caractères large qui spécifie le nom du nœud de la cible.
TSID
Valeur interne qui spécifie la partie de l’ID de session iSCSI fourni par la cible. Le protocole iSCSI utilise TSID avec ISID pour identifier la session. Ne confondez pas TSID avec l’ID de session spécifié par UniqueSessionId .
ISID[6]
Valeur interne qui spécifie la partie de l’ID de session iSCSI fourni par l’initiateur.
InitialR2t
Valeur booléenne qui indique si l’initiateur doit attendre une demande de prêt à envoyer (R2T) avant d’envoyer des données à la cible. Si ce membre a la valeur TRUE, l’initiateur doit attendre une demande de prêt à envoyer (R2T) avant d’envoyer des données à la cible. Si ce membre a la valeur FALSE, l’initiateur peut envoyer des données non sollicitées dans les limites spécifiées par la valeur de FirstBurstLength .
ImmediateData
Valeur booléenne qui indique si l’initiateur et la cible ont accepté d’autoriser la transmission de données immédiates dans la session. (Les données immédiates sont des données que l’initiateur récupère sur une commande iSCSI PDU.) Si ce membre a la valeur TRUE, l’initiateur et la cible ont accepté d’autoriser la transmission de données immédiates dans cette session.
Type
Valeur d’énumération ISCSI_SESSION_TYPE_QUALIFIERS qui spécifie le type de session d’ouverture de session.
| Type | Signification |
|---|---|
| discoverySession | La session est utilisée uniquement pour la découverte. |
| informationtalSession | La session est utilisée pour un ensemble limité de commandes SCSI. |
| dataSession | La session est utilisée comme session de fonctionnalité complète. |
| bootSession | La session est utilisée pour démarrer à partir de la cible. |
DataSequenceInOrder
Valeur booléenne qui indique si les séquences de PPU de données doivent être transmises à l’aide de décalages en constante augmentation, sauf pendant la récupération d’erreur. Si ce membre a la valeur TRUE, les séquences de PKU de données doivent être transmises à l’aide de décalages croissants en continu, sauf pendant la récupération d’erreur. Si ce membre a la valeur FALSE, les séquences de PPU de données peuvent être transmises dans n’importe quel ordre.
La valeur dans DataSequenceInOrder indique l’ordre des séquences elles-mêmes, et non l’ordre des PPU de données au sein de chaque séquence. Le membre DataPduInOrder indique l’ordre des PDU de données au sein de chaque séquence.
DataPduInOrder
Valeur booléenne qui indique si les PPU de données dans une séquence de PPU de données doivent se trouver à des adresses en constante augmentation. Si ce membre a la valeur TRUE, les PPU de données dans une séquence de PPU de données doivent se trouver à des adresses en constante augmentation, sans écarts ni superposition entre les PDP. Si ce membre a la valeur FALSE, les PPU de données au sein de chaque séquence peuvent être dans n’importe quel ordre.
ErrorRecoveryLevel
Niveau de récupération d’erreur que l’initiateur et la cible ont négocié. Des nombres plus élevés représentent des schémas de récupération plus élaborés. Actuellement, ce membre doit être égal à 0 ou ULONG_VALUE_UNKNOWN.
MaxOutstandingR2t
Nombre maximal de demandes prêtes à transmettre (R2T) en attente autorisées pour chaque tâche au cours de cette session.
FirstBurstLength
Quantité maximale de données non sollicitées, en octets, que vous pouvez envoyer dans cette session.
MaxBurstLength
Nombre maximal d’octets que vous pouvez envoyer dans une séquence unique de Data-In ou Data-Out PPU.
MaxConnections
Nombre maximal de connexions autorisées dans cette session.
ConnectionCount
Nombre de connexions qui appartiennent actuellement à cette session.
ConnectionsList[1]
Tableau de longueur variable de structures ISCSI_ConnectionStaticInfo qui spécifie les données de configuration statiques pour chaque connexion associée à cette session. ConnectionCount indique le nombre d’éléments dans le tableau.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | iscsimgt.h (inclure Iscsimgt.h) |