struttura ISCSI_SessionStaticInfo (iscsimgt.h)
La struttura ISCSI_SessionStaticInfo fornisce informazioni sulle caratteristiche di una sessione iSCSI.
Sintassi
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;
Membri
UniqueSessionId
Intero a 64 bit che identifica in modo univoco la sessione. I metodi LoginToTarget e AddConnectionToSession restituiscono entrambi questo valore nel parametro UniqueSessionId. Non confondere questo valore con i valori nei membri ISID e TSID.
InitiatoriSCSIName[223 + 1]
Stringa di caratteri wide che specifica il nome del nodo dell'iniziatore.
TargetiSCSIName[223 + 1]
Stringa di caratteri wide che specifica il nome del nodo della destinazione.
TSID
Valore interno che specifica la parte dell'ID sessione iSCSI fornito dalla destinazione. Il protocollo iSCSI usa TSID insieme a ISID per identificare la sessione. Non confondere TSID con l'ID sessione specificato UniqueSessionId.
ISID[6]
Valore interno che specifica la parte dell'ID sessione iSCSI fornito dall'iniziatore.
InitialR2t
Valore booleano che indica se l'iniziatore deve attendere una richiesta pronta per l'invio (R2T) prima di inviare dati alla destinazione. Se questo membro è TRUE, l'iniziatore deve attendere una richiesta R2T (Ready-to-Send) prima di inviare dati alla destinazione. Se questo membro è FALSE, l'iniziatore può inviare dati non richiesti entro i limiti specificati dal valore di FirstBurstLength.
ImmediateData
Valore booleano che indica se l'iniziatore e la destinazione hanno accettato di consentire la trasmissione di dati immediati nella sessione. (I dati immediati sono dati che l'iniziatore esegue il piggyback in un comando iSCSI PDU. Se questo membro è TRUE, l'iniziatore e la destinazione hanno accettato di consentire la trasmissione di dati immediati in questa sessione.
Type
Valore di enumerazione ISCSI_SESSION_TYPE_QUALIFIERS che specifica il tipo di sessione di accesso.
| Digitare | Significato |
|---|---|
| discoverySession | La sessione viene usata solo per l'individuazione. |
| informationtalSession | La sessione viene usata per un set limitato di comandi SCSI. |
| dataSession | La sessione viene usata come sessione completa delle funzionalità. |
| bootSession | La sessione viene usata per l'avvio dalla destinazione. |
DataSequenceInOrder
Valore booleano che indica se le sequenze di PDU di dati devono essere trasmesse utilizzando offset in aumento continuo, tranne durante il recupero degli errori. Se questo membro è TRUE, le sequenze di PDU di dati devono essere trasmesse usando offset in aumento continuo, tranne durante il ripristino degli errori. Se questo membro è FALSE, le sequenze di PDU di dati possono essere trasmesse in qualsiasi ordine.
Il valore in DataSequenceInOrder indica l'ordinamento delle sequenze stesse, non l'ordinamento delle PDU dati all'interno di ogni sequenza. Il membro dataPduInOrder indica l'ordinamento delle PDU dati all'interno di ogni sequenza.
DataPduInOrder
Valore booleano che indica se i PDU di dati all'interno di una sequenza di PDU di dati devono trovarsi in indirizzi in continua aumento. Se questo membro è TRUE, le PDU di dati all'interno di una sequenza di PDU di dati devono trovarsi in indirizzi in aumento continuo, senza gap o sovrapposizioni tra pdu. Se questo membro è FALSE, i PDU dati all'interno di ogni sequenza possono essere in qualsiasi ordine.
ErrorRecoveryLevel
Livello di recupero degli errori negoziato dall'iniziatore e dalla destinazione. I numeri più alti rappresentano schemi di recupero più elaborati. Attualmente, questo membro deve essere 0 o ULONG_VALUE_UNKNOWN.
MaxOutstandingR2t
Numero massimo di richieste R2T (Ready-to-Transmit) in sospeso consentite per ogni attività all'interno di questa sessione.
FirstBurstLength
Quantità massima di dati non richiesti, in byte, che è possibile inviare all'interno di questa sessione.
MaxBurstLength
Numero massimo di byte che è possibile inviare all'interno di una singola sequenza di Data-In o Data-Out PDU.
MaxConnections
Numero massimo di connessioni consentite all'interno di questa sessione.
ConnectionCount
Numero di connessioni attualmente appartenenti a questa sessione.
ConnectionsList[1]
Matrice di lunghezza variabile di strutture di ISCSI_ConnectionStaticInfo che specifica i dati di configurazione statici per ogni connessione associata a questa sessione. ConnectionCount indica il numero di elementi nella matrice.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | iscsimgt.h (include Iscsimgt.h) |