ISCSI_LoginOptions struttura (iscsidef.h)
La struttura ISCSI_LoginOptions definisce le caratteristiche di una sessione di accesso. Le routine LoginToTarget_IN usano queste caratteristiche definite mentre accede a una destinazione iSCSI.
Sintassi
typedef struct _ISCSI_LoginOptions {
ULONG InformationSpecified;
ULONG HeaderDigest;
ULONG DataDigest;
ULONG MaximumConnections;
ULONG DefaultTime2Wait;
ULONG DefaultTime2Retain;
ULONG LoginFlags;
ULONG AuthType;
} ISCSI_LoginOptions, *PISCSI_LoginOptions;
Members
InformationSpecified
Bitmap che indica quali membri della struttura ISCSI_LoginOptions contengono dati validi. La tabella seguente descrive i valori possibili:
| bit | Descrizione |
|---|---|
| ISCSI_LOGIN_OPTIONS_HEADER_DIGEST | Il membro HeaderDigest specifica il tipo di digest utilizzato per garantire l'integrità dei dati di intestazione. |
| ISCSI_LOGIN_OPTIONS_DATA_DIGEST | Il membro DataDigest specifica il tipo di digest utilizzato per garantire l'integrità dei dati dell'intestazione. |
| ISCSI_LOGIN_OPTIONS_MAXIMUM_CONNECTIONS | Il membro MaximumConnections specifica il numero massimo di connessioni consentite nella sessione iSCSI. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_WAIT | Il membro DefaultTime2Wait specifica il tempo minimo di attesa, in secondi, prima che l'iniziatore tenti di riconnettersi o riassegnare una connessione eliminata. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_RETAIN | Il membro DefaultTime2Retain specifica il tempo massimo consentito per riassegnare i comandi dopo l'attesa iniziale inDicata in DefaultTime2Wait. |
| ISCSI_LOGIN_OPTIONS_AUTH_TYPE | Il membro AuthType specifica il tipo di autenticazione che stabilisce la sessione di accesso. |
| ISCSI_LOGIN_OPTIONS_USERNAME | Nome utente da usare durante l'accesso. |
| ISCSI_LOGIN_OPTIONS_PASSWORD | Password da usare durante l'accesso. |
HeaderDigest
Valore ISCSI_DIGEST_TYPES che indica il metodo usato dall'iniziatore per verificare l'integrità del digest di intestazione in un PDU di accesso.
DataDigest
Valore ISCSI_DIGEST_TYPES che indica il metodo usato dall'iniziatore per verificare l'integrità del digest dei dati in un PDU di accesso.
MaximumConnections
Valore compreso tra 1 e 65535 che specifica il numero massimo di connessioni ai dispositivi di destinazione che possono essere associati a una singola sessione di accesso. Un valore pari a 0 indica che non esiste alcun limite al numero di connessioni.
DefaultTime2Wait
Tempo minimo di attesa, in secondi, prima che l'iniziatore tenti di riconnettersi o riassegnare una connessione (o un'attività) che è stata eliminata dopo una terminazione o reimpostazione imprevista della connessione. L'iniziatore e la negoziazione di destinazione per determinare questo valore.
DefaultTime2Retain
Tempo massimo, in secondi, per riassegnare una connessione dopo l'attesa iniziale in DefaultTime2Wait . L'iniziatore e la negoziazione di destinazione per determinare questo valore.
LoginFlags
Or bit per bit dei flag di accesso che definiscono determinate caratteristiche della sessione di accesso. La tabella seguente indica i valori che è possibile assegnare a questo membro.
| Flag di accesso | Significato |
|---|---|
| ISCSI_LOGIN_FLAG_REQUIRE_IPSEC | La sessione di accesso deve usare il protocollo IPSec. |
| ISCSI_LOGIN_FLAG_MULTIPATH_ENABLED | Il software multipathing è installato, quindi il servizio iniziatore iSCSI consente più sessioni alla stessa destinazione. |
| ISCSI_LOGIN_FLAG_RESERVED1 | Solo per uso interno di Microsoft. |
| ISCSI_LOGIN_FLAG_ALLOW_PORTAL_HOPPING | Se un portale di destinazione non è disponibile per l'accesso, l'iniziatore può "hop" tramite l'elenco dei portali di destinazione individuati e che può essere usato per le operazioni di accesso. Ovvero, l'iniziatore continuerà a provare l'elenco di portali disponibili fino a quando non trova uno che può essere usato per l'accesso, quindi può accedere al portale di destinazione disponibile. |
| ISCSI_LOGIN_FLAG_USE_RADIUS_RESPONSE | Usare RADIUS per generare la risposta CHAP. |
| ISCSI_LOGIN_FLAG_USE_RAIDUS_VERIFICATION | Usare RADIUS per verificare la risposta CHAP. |
AuthType
Valore ISCSI_AUTH_TYPES che indica il metodo di autenticazione usato per stabilire una connessione di accesso.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | iscsidef.h (includere Iscsidef.h) |