структура AddConnectionToSession_IN (iscsiop.h)

Статья
08/07/2023

Структура AddConnectionToSession_IN содержит входные данные для метода AddConnectionToSession , который используется для добавления нового подключения к уже существующему сеансу.

Синтаксис

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;

Члены

UniqueAdapterId

64-разрядное целое число, однозначно идентифицирующее адаптер и конкретный загруженный экземпляр драйвера минипорта хранилища, который управляет адаптером. Этот идентификатор уникален не только на компьютере, где находится адаптер, но и во всей сети.

UniqueSessionId

64-разрядное целое число, однозначно определяющее сеанс. Методы LoginToTarget и AddConnectionToSession возвращают это значение в параметре UniqueSessionId . Не путайте это значение со значениями в членах ISID и TSID.

SecurityFlags

Побитовое ИЛИ флагов, указывающих требования к безопасности целевого объекта. Список возможных значений для этого элемента см. в разделе SECURITY_FLAG_QUALIFIERS.

PortNumber

Номер порта, с которого следует инициировать целевой сеанс входа.

LoginOptions

Структура ISCSI_LoginOptions , описывающая характеристики целевого сеанса входа, к которому будет добавлено подключение.

TargetPortal

Структура ISCSI_TargetPortal , указывающая, какой целевой портал следует использовать для установки дополнительного подключения. Метод AddConnectionToSession вызывает метод LoginToTarget для установки нового подключения. Если loginToTarget завершается сбоем со значением состояния ISCSC_TARGET_MOVED_PERMANENTLY или ISCSC_TARGET_MOVED_TEMPORARILY. TargetPortal укажет в выходных данных AddConnectionToSession портал, на который должна быть перенаправлена операция входа. Дополнительные сведения о значениях состояния ISCSC_TARGET_MOVED_PERMANENTLY и ISCSC_TARGET_MOVED_TEMPORARILY см. в разделе ISCSI_STATUS_QUALIFIERS.

UsernameSize

Размер имени пользователя в байтах.

PasswordSize

Размер пароля в байтах.

KeySize

Общий размер ключа в байтах.

Key[1]

Массив символов переменной длины, указывающий общий ключ, связанный с целевым IP-адресом. Количество элементов в массиве задается полем KeySize.