LoginToTarget

El método LoginToTarget indica a un controlador de minipuerto que administra un iniciador de HBA para iniciar sesión en un portal de destino.

Los controladores miniport que implementan la clase WMI de MSiSCSI_Operations deben admitir este método.

El controlador de minipuerto debe exponer información sobre la sesión que crea a través de la clase WMI de MSiSCSI_InitiatorSessionInfo.

En la tabla siguiente se describen los tipos de sesiones de inicio de sesión que los iniciadores pueden establecer.

Sesión de inicio de sesión	Descripción
Detección	Una sesión de detección se usa exclusivamente para las operaciones SendTargets .
Informativo	Una sesión informativa permite al iniciador consultar el destino para obtener información, pero el iniciador no notifica números de unidad lógica (LUN) en el destino al administrador de Plug and Play (PnP); el controlador de puerto de almacenamiento no enumera los LUN ni los expone como dispositivos locales. Las aplicaciones de administración pueden consultar estos LUN remotos estableciendo una sesión informativa y llamando a rutinas de biblioteca en modo de usuario iSCSI, como SendScsiInquiry, SendScsiReportLuns y SendScsiReadCapacity.
data	Una sesión de datos es una sesión completa. El controlador de minipuerto que inicia la sesión debe notificar los LUN en el destino al controlador de puerto, por lo que el controlador de puerto los enumerará y cargará los controladores adecuados. El software puede acceder a estos dispositivos remotos como si fueran dispositivos locales.
Arranque	Una sesión de arranque es una sesión completa en la que se usa el LUN iSCSI como dispositivo de arranque.

El identificador (ID) que el método LoginToTarget asigna a la sesión debe permanecer constante durante la vigencia de una sesión. Incluso si los inicios de sesión asincrónicos o los eventos de red interrumpen la conexión con el destino y obligan al controlador de miniporte a volver a conectarse, el controlador de minipuerto debe seguir usando el mismo identificador de sesión.

Los controladores de minipuerto deben usar las siguientes directrices cuando restablezcan los datos y las sesiones informativas:

Intentos de reconexión periódicos
El controlador de minipuerto debe intentar volver a conectarse periódicamente (se recomiendan intervalos de 5 segundos) hasta que un inicio de sesión se realice correctamente o el controlador de miniporte reciba una solicitud de cierre de sesión.

Latencia de eliminación de dispositivos
El controlador de minipuerto no debe quitar inmediatamente las unidades lógicas del destino de la pila de dispositivos del sistema operativo local. En su lugar, el controlador de minipuerto debe usar datos almacenados localmente en caché para procesar las solicitudes INQUIRY y REPORT LUNS y las solicitudes de cola que el controlador de miniporte debe enviar al destino remoto para su procesamiento.

Si el controlador de miniporte no puede restablecer una sesión con el destino después de aproximadamente 60 segundos, debe quitar las unidades lógicas del destino de la pila de dispositivos local. Al introducir la latencia de 60 segundos en la eliminación de dispositivos de la pila de dispositivos, el controlador de miniporte puede evitar interrumpir innecesariamente el trabajo de las aplicaciones locales que acceden a los datos en el destino remoto. Sin embargo, una latencia de más de 60 segundos podría requerir que el controlador de miniporte poner en cola un gran número de solicitudes, y estas solicitudes podrían consumir potencialmente una cantidad inaceptable de recursos del sistema. El tiempo de latencia exacto debe ser configurable.

El método WMI LoginToTarget pertenece a la clase WMI de MSiSCSI_Operations.

Para obtener una explicación del algoritmo que usa la biblioteca de modo de usuario iSCSI para establecer un registro, consulte LoginIScsiTarget.