LoginToTarget

Il metodo LoginToTarget indica a un driver miniport che gestisce un iniziatore HBA per accedere a un portale di destinazione.

I driver Miniport che implementano la classe WMI MSiSCSI_Operations devono supportare questo metodo.

Il driver miniport deve esporre informazioni sulla sessione creata tramite la classe WMI MSiSCSI_InitiatorSessionInfo.

Nella tabella seguente vengono descritti i tipi di sessioni di accesso che possono essere stabilite dagli iniziatori.

Sessione di accesso	Descrizione
Individuazione	Una sessione di individuazione viene usata esclusivamente per le operazioni SendTargets .
Informativo	Una sessione informativa consente all'iniziatore di eseguire una query sulla destinazione per ottenere informazioni, ma l'iniziatore non segnala i numeri di unità logica (LUN) nella destinazione al gestore Plug and Play (PnP), mentre il driver della porta di archiviazione non enumera i LUN o li espone come dispositivi locali. Le applicazioni di gestione possono eseguire query su questi LUN remoti stabilendo una sessione informativa e chiamando routine di libreria in modalità utente iSCSI, ad esempio SendScsiIquery, SendScsiReportLuns e SendScsiReadCapacity.
Dati	Una sessione dati è una sessione completa. Il driver miniport che avvia la sessione deve segnalare i LUN sulla destinazione al driver della porta, in modo che il driver della porta enumerarli e caricare i driver appropriati. Il software può accedere a questi dispositivi remoti come se fossero dispositivi locali.
Avvio	Una sessione di avvio è una sessione completa in cui il LUN iSCSI viene usato come dispositivo di avvio.

L'identificatore (ID) assegnato dal metodo LoginToTarget alla sessione deve rimanere costante per la durata di una sessione. Anche se i logoff asincroni o gli eventi di rete eseguono la connessione alla destinazione e forzano la riconnessione del driver miniport, il driver miniport deve continuare a usare lo stesso ID sessione.

I driver Miniport devono usare le linee guida seguenti per ristabilire i dati e le sessioni informative:

Tentativi di riconnessione periodici
Il driver miniport deve tentare periodicamente di riconnettersi (sono consigliati intervalli di 5 secondi) fino a quando un accesso non riesce o il driver miniport riceve una richiesta di disconnessione.

Latenza di rimozione dei dispositivi
Il driver miniport non deve rimuovere immediatamente le unità logiche della destinazione dallo stack di dispositivi del sistema operativo locale. Al contrario, il driver miniport deve usare i dati memorizzati nella cache locale per elaborare le richieste LUNS e REPORT LUNS e le richieste di coda che il driver miniport deve inviare alla destinazione remota per l'elaborazione.

Se il driver miniport non è in grado di ristabilire una sessione con la destinazione dopo circa 60 secondi, deve rimuovere le unità logiche della destinazione dallo stack di dispositivi locale. Introducendo la latenza di 60 secondi nella rimozione dei dispositivi dallo stack di dispositivi, il driver miniport può evitare di interrompere inutilmente il lavoro delle applicazioni locali che accedono ai dati nella destinazione remota. Tuttavia, una latenza di più di 60 secondi potrebbe richiedere al driver miniport di accodare un numero elevato di richieste e queste richieste potrebbero potenzialmente utilizzare una quantità inaccettabile di risorse di sistema. Il tempo di latenza esatta deve essere configurabile.

Il metodo WMI LoginToTarget appartiene alla classe WMI MSiSCSI_Operations.

Per una spiegazione dell'algoritmo usato dalla libreria in modalità utente iSCSI per stabilire un log, vedere LoginIScsiTarget.