structure ISCSI_SessionStaticInfo (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 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 du ISID et membres 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 qui UniqueSessionId spécifie.
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 requête prête à l’envoi (R2T) avant d’envoyer des données à la cible. Si ce membre est TRUE, l’initiateur doit attendre une demande prête à l’envoi (R2T) avant d’envoyer des données à la cible. Si ce membre est FALSE, l’initiateur peut envoyer des données non sollicitées dans des limites que la valeur de FirstBurstLength spécifie.
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. (données immédiates est des données que l’initiateur piggybacks sur une commande iSCSI PDU.) Si ce membre est 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 des séquences de PDU de données doivent être transmises à l’aide de décalages croissants en continu, sauf lors de la récupération d’erreur. Si ce membre est TRUE, les séquences de pdus de données doivent être transmises à l’aide de décalages croissants en continu, à l’exception de la récupération d’erreur. Si ce membre est FALSE, les séquences de pdus de données peuvent être transmises dans n’importe quel ordre.
La valeur de DataSequenceInOrder indique l’ordre des séquences elles-mêmes, et non l’ordre des PDU de données dans chaque séquence. Le membre DataPduInOrder indique l’ordre des PDU de données dans chaque séquence.
DataPduInOrder
Valeur booléenne qui indique si les PDU de données dans une séquence de PDU de données doivent se trouver à des adresses croissantes en continu. Si ce membre est TRUE, les PDU de données dans une séquence de PDU de données doivent se trouver à des adresses croissantes en continu, sans lacunes ni superposition entre les PDU. Si ce membre est FALSE, les pdus de données dans chaque séquence peuvent être dans n’importe quel ordre.
ErrorRecoveryLevel
Niveau de récupération d’erreur négocié par l’initiateur et la cible. 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 requêtes prêtes à transmettre (R2T) en attente autorisées pour chaque tâche au sein 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 seule séquence de Data-In ou de Data-Out DE PDU.
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 statique pour chaque connexion associée à cette session. ConnectionCount indique le nombre d’éléments dans le tableau.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | iscsimgt.h (inclure Iscsimgt.h) |