structure ISCSI_LoginOptions (iscsidef.h)
La structure ISCSI_LoginOptions définit les caractéristiques d’une session d’ouverture de session. Les routines LoginToTarget_IN utilisent ces caractéristiques définies lorsqu’elles se connectent à une cible iSCSI.
Syntaxe
typedef struct _ISCSI_LoginOptions {
ULONG InformationSpecified;
ULONG HeaderDigest;
ULONG DataDigest;
ULONG MaximumConnections;
ULONG DefaultTime2Wait;
ULONG DefaultTime2Retain;
ULONG LoginFlags;
ULONG AuthType;
} ISCSI_LoginOptions, *PISCSI_LoginOptions;
Membres
InformationSpecified
Bitmap qui indique quels membres de la structure ISCSI_LoginOptions contiennent des données valides. Le tableau suivant décrit les valeurs possibles :
| bit | Description |
|---|---|
| ISCSI_LOGIN_OPTIONS_HEADER_DIGEST | Le membre HeaderDigest spécifie le type de synthèse utilisé pour garantir l’intégrité des données d’en-tête. |
| ISCSI_LOGIN_OPTIONS_DATA_DIGEST | Le membre DataDigest spécifie le type de synthèse utilisé pour garantir l’intégrité des données d’en-tête. |
| ISCSI_LOGIN_OPTIONS_MAXIMUM_CONNECTIONS | Le membre MaximumConnections spécifie le nombre maximal de connexions autorisées dans la session iSCSI. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_WAIT | Le membre DefaultTime2Wait spécifie la durée minimale d’attente, en secondes, avant que l’initiateur tente de se reconnecter ou de réaffecter une connexion qui a été supprimée. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_RETAIN | Le membre DefaultTime2Retain spécifie la durée maximale autorisée pour réaffecter les commandes après l’attente initiale indiquée dans DefaultTime2Wait. |
| ISCSI_LOGIN_OPTIONS_AUTH_TYPE | Le membre AuthType spécifie le type d’authentification qui établit la session d’ouverture de session. |
| ISCSI_LOGIN_OPTIONS_USERNAME | Nom d’utilisateur à utiliser pendant l’ouverture de session. |
| ISCSI_LOGIN_OPTIONS_PASSWORD | Mot de passe à utiliser lors de l’ouverture de session. |
HeaderDigest
Valeur ISCSI_DIGEST_TYPES qui indique la méthode que l’initiateur utilise pour vérifier l’intégrité de l’en-tête digest dans une PDU d’ouverture de session.
DataDigest
Valeur de ISCSI_DIGEST_TYPES qui indique la méthode que l’initiateur utilise pour vérifier l’intégrité de la synthèse des données dans une PDU de connexion.
MaximumConnections
Valeur comprise entre 1 et 65535 qui spécifie le nombre maximal de connexions à des appareils cibles pouvant être associées à une session d’ouverture de session unique. La valeur 0 indique qu’il n’existe aucune limite au nombre de connexions.
DefaultTime2Wait
Délai minimal d’attente, en secondes, avant que l’initiateur tente de se reconnecter ou de réaffecter une connexion (ou une tâche) qui a été supprimée après une interruption ou une réinitialisation inattendue de la connexion. L’initiateur et la cible négocient pour déterminer cette valeur.
DefaultTime2Retain
Durée maximale, en secondes, de réaffectation d’une connexion après l’attente initiale indiquée dans DefaultTime2Wait . L’initiateur et la cible négocient pour déterminer cette valeur.
LoginFlags
OR au niveau du bit des indicateurs d’ouverture de session qui définissent certaines caractéristiques de la session d’ouverture de session. Le tableau suivant indique les valeurs que vous pouvez affecter à ce membre.
| Indicateur de connexion | Signification |
|---|---|
| ISCSI_LOGIN_FLAG_REQUIRE_IPSEC | La session d’ouverture de session doit utiliser le protocole IPSec. |
| ISCSI_LOGIN_FLAG_MULTIPATH_ENABLED | Le logiciel multipathing étant installé, le service initiateur iSCSI autorise plusieurs sessions sur la même cible. |
| ISCSI_LOGIN_FLAG_RESERVED1 | Réservé à un usage interne Microsoft. |
| ISCSI_LOGIN_FLAG_ALLOW_PORTAL_HOPPING | Si un portail cible n’est pas disponible pour la connexion, l’initiateur peut « parcourir » la liste des portails cibles qu’il a découverts et qui peuvent être utilisés pour les opérations de connexion. Autrement dit, l’initiateur continue d’essayer la liste des portails disponibles jusqu’à ce qu’il en trouve un qui peut être utilisé pour la connexion, afin qu’il puisse ensuite se connecter au portail cible disponible. |
| ISCSI_LOGIN_FLAG_USE_RADIUS_RESPONSE | Utilisez RADIUS pour générer une réponse CHAP. |
| ISCSI_LOGIN_FLAG_USE_RAIDUS_VERIFICATION | Utilisez RADIUS pour vérifier la réponse CHAP. |
AuthType
Valeur ISCSI_AUTH_TYPES qui indique la méthode d’authentification utilisée pour établir une connexion d’ouverture de session.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | iscsidef.h (inclure Iscsidef.h) |