estructura ISCSI_LoginOptions (iscsidef.h)
La estructura ISCSI_LoginOptions define las características de una sesión de inicio de sesión. Las rutinas de LoginToTarget_IN usan estas características definidas mientras se registra en un destino iSCSI.
Sintaxis
typedef struct _ISCSI_LoginOptions {
ULONG InformationSpecified;
ULONG HeaderDigest;
ULONG DataDigest;
ULONG MaximumConnections;
ULONG DefaultTime2Wait;
ULONG DefaultTime2Retain;
ULONG LoginFlags;
ULONG AuthType;
} ISCSI_LoginOptions, *PISCSI_LoginOptions;
Miembros
InformationSpecified
Mapa de bits que indica qué miembros de la estructura ISCSI_LoginOptions contienen datos válidos. En la tabla siguiente se describen los valores posibles:
| bit | Descripción |
|---|---|
| ISCSI_LOGIN_OPTIONS_HEADER_DIGEST | El miembro HeaderDigest especifica el tipo de resumen que se usa para garantizar la integridad de los datos de encabezado. |
| ISCSI_LOGIN_OPTIONS_DATA_DIGEST | El miembro DataDigest especifica el tipo de resumen que se usa para garantizar la integridad de los datos de encabezado. |
| ISCSI_LOGIN_OPTIONS_MAXIMUM_CONNECTIONS | El miembro MaximumConnections especifica el número máximo de conexiones permitidas en la sesión iSCSI. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_WAIT | El miembro DefaultTime2Wait especifica el tiempo mínimo de espera, en segundos, antes de que el iniciador intente volver a conectarse o reasignar una conexión que se quitó. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_RETAIN | El miembro DefaultTime2Retain especifica el tiempo máximo que se permite reasignar comandos después de la espera inicial indicada en DefaultTime2Wait. |
| ISCSI_LOGIN_OPTIONS_AUTH_TYPE | El miembro AuthType especifica el tipo de autenticación que establece la sesión de inicio de sesión. |
| ISCSI_LOGIN_OPTIONS_USERNAME | Nombre de usuario que se va a usar durante el inicio de sesión. |
| ISCSI_LOGIN_OPTIONS_PASSWORD | Contraseña que se va a usar durante el inicio de sesión. |
HeaderDigest
Valor ISCSI_DIGEST_TYPES que indica el método que usa el iniciador para comprobar la integridad del resumen de encabezado en una PDU de inicio de sesión.
DataDigest
Valor ISCSI_DIGEST_TYPES que indica el método que usa el iniciador para comprobar la integridad del resumen de datos en una PDU de inicio de sesión.
MaximumConnections
Valor entre 1 y 65535 que especifica el número máximo de conexiones a dispositivos de destino que se pueden asociar a una sola sesión de inicio de sesión. Un valor de 0 indica que no hay límite para el número de conexiones.
DefaultTime2Wait
Tiempo mínimo de espera, en segundos, antes de que el iniciador intente volver a conectarse o reasignar una conexión (o tarea) que se ha quitado después de una terminación o restablecimiento de conexión inesperados. El iniciador y el destino negocian para determinar este valor.
DefaultTime2Retain
Tiempo máximo, en segundos, para reasignar una conexión después de que haya transcurrido la espera inicial indicada en DefaultTime2Wait . El iniciador y el destino negocian para determinar este valor.
LoginFlags
Or bit a bit de marcas de inicio de sesión que definen determinadas características de la sesión de inicio de sesión. En la tabla siguiente se indican los valores que se pueden asignar a este miembro.
| Marca de inicio de sesión | Significado |
|---|---|
| ISCSI_LOGIN_FLAG_REQUIRE_IPSEC | La sesión de inicio de sesión debe usar el protocolo IPSec. |
| ISCSI_LOGIN_FLAG_MULTIPATH_ENABLED | El software de múltiples rutas está instalado, por lo que el servicio de iniciador iSCSI permite varias sesiones al mismo destino. |
| ISCSI_LOGIN_FLAG_RESERVED1 | Solo para uso interno de Microsoft. |
| ISCSI_LOGIN_FLAG_ALLOW_PORTAL_HOPPING | Si un portal de destino no está disponible para el inicio de sesión, el iniciador puede "saltar" a través de la lista de portales de destino que detectó y que se puede usar para las operaciones de inicio de sesión. Es decir, el iniciador seguirá probando la lista de portales que están disponibles hasta que encuentre uno que se pueda usar para el inicio de sesión, por lo que puede iniciar sesión en el portal de destino disponible. |
| ISCSI_LOGIN_FLAG_USE_RADIUS_RESPONSE | Use RADIUS para generar la respuesta CHAP. |
| ISCSI_LOGIN_FLAG_USE_RAIDUS_VERIFICATION | Use RADIUS para comprobar la respuesta chap. |
AuthType
Valor de ISCSI_AUTH_TYPES que indica el método de autenticación que se usa para establecer una conexión de inicio de sesión.
Requisitos
| Requisito | Valor |
|---|---|
| Header | iscsidef.h (incluir Iscsidef.h) |