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

Статья
02/07/2025

Структура 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.