struttura AddConnectionToSession_IN (iscsiop.h)

Articolo
02/26/2024

La struttura AddConnectionToSession_IN contiene i dati di input per il metodo AddConnectionToSession , usato per aggiungere una nuova connessione a una sessione già esistente.

Sintassi

typedef struct _AddConnectionToSession_IN {
  ULONGLONG          UniqueAdapterId;
  ULONGLONG          UniqueSessionId;
  ULONGLONG          SecurityFlags;
  ULONG              PortNumber;
  ISCSI_LoginOptions LoginOptions;
  ISCSI_TargetPortal TargetPortal;
  ULONG              UsernameSize;
  ULONG              PasswordSize;
  ULONG              KeySize;
  UCHAR              Key[1];
} AddConnectionToSession_IN, *PAddConnectionToSession_IN;

Members

UniqueAdapterId

Intero a 64 bit che identifica in modo univoco un adattatore e una particolare istanza caricata di un driver miniport di archiviazione che gestisce l'adattatore. Questo identificatore è univoco, non solo nel computer in cui si trova la scheda, ma anche nell'intera rete.

UniqueSessionId

Intero a 64 bit che identifica in modo univoco la sessione. I metodi LoginToTarget e AddConnectionToSession restituiscono entrambi questo valore nel parametro UniqueSessionId . Non confondere questo valore con i valori nei membri ISID e TSID.

SecurityFlags

OR bit per bit dei flag che indicano i requisiti di sicurezza di una destinazione. Per un elenco dei valori possibili per questo membro, vedere SECURITY_FLAG_QUALIFIERS.

PortNumber

Numero della porta da cui avviare la sessione di accesso di destinazione.

LoginOptions

Struttura ISCSI_LoginOptions che descrive le caratteristiche della sessione di accesso di destinazione a cui verrà aggiunta una connessione.

TargetPortal

Struttura ISCSI_TargetPortal che indica il portale di destinazione da usare per stabilire la connessione aggiuntiva. Il metodo AddConnectionToSession chiama il metodo LoginToTarget per stabilire la nuova connessione. Se LoginToTarget ha esito negativo con un valore di stato di ISCSC_TARGET_MOVED_PERMANENTLY o di ISCSC_TARGET_MOVED_TEMPORARILY. TargetPortal indicherà, all'output di AddConnectionToSession, il portale a cui deve essere reindirizzata l'operazione di accesso. Per altre informazioni sui valori di stato ISCSC_TARGET_MOVED_PERMANENTLY e ISCSC_TARGET_MOVED_TEMPORARILY, vedere ISCSI_STATUS_QUALIFIERS.

UsernameSize

Dimensioni del nome utente, in byte.

PasswordSize

Dimensioni della password, in byte.

KeySize

Dimensione della chiave precondivisa, in byte.

Key[1]

Matrice di caratteri a lunghezza variabile che specifica la chiave precondivisa associata all'indirizzo IP di destinazione. Il numero di elementi nella matrice viene specificato dal campo KeySize.