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

Статья
03/01/2024

Структура LoginToTarget_IN содержит входные данные для метода LoginToTarget , который используется для входа в целевой объект.

Синтаксис

typedef struct _LoginToTarget_IN {
  ULONG               PortNumber;
  ISCSI_LoginOptions  LoginOptions;
  ULONG               SessionType;
  ULONGLONG           SecurityFlags;
  ISCSI_TargetPortal  TargetPortal;
  ULONG               UsernameSize;
  ULONG               PasswordSize;
  ULONG               KeySize;
  USHORT              UniqueIdForISID;
  BOOLEAN             PersistentLogin;
  WCHAR               InitiatorNode[223 + 1];
  WCHAR               InitiatorAlias[255 + 1];
  WCHAR               TargetName[223 + 1];
  ISCSI_TargetMapping Mappings;
  UCHAR               Key[1];
} LoginToTarget_IN, *PLoginToTarget_IN;

Члены

PortNumber

Номер порта (портала инициатора), который инициатор HBA использует для установки сеанса входа. Это значение должно соответствовать элементу Indexструктуры ISCSI_PortalInfo .

LoginOptions

Структура ISCSI_LoginOptions , указывающая характеристики сеанса входа.

SessionType

Значение перечисления LOGINSESSIONTYPE , указывающее тип сеанса входа.

SecurityFlags

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

TargetPortal

Структура ISCSI_TargetPortal , указывающая, какой целевой портал следует использовать для подключения.

UsernameSize

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

PasswordSize

Размер строки в байтах в поле Пароль.

KeySize

Размер строки в байтах в key.

UniqueIdForISID

Номер, который драйвер мини-порта, управляющий HBA, может использовать для создания уникального идентификатора сеанса (ISID).

PersistentLogin

Логическое значение, указывающее, должен ли вход в систему быть постоянным. Если этот элемент имеет значение TRUE, вход должен быть постоянным. Драйвер мини-порта HBA должен хранить характеристики этого входа в энергонезависимую память и автоматически входить в целевой объект каждый раз, когда операционная система загружает драйвер мини-порта. Если этот элемент имеет значение FALSE, вход не является постоянным.

InitiatorNode[223 + 1]

Имя iSCSI узла инициатора, используемого для подключения. Если этот элемент пуст, драйвер мини-порта HBA может выбрать любое имя узла инициатора во время проверки подлинности. Имя узла инициатора обычно является полным именем iSCSI (IQN).

InitiatorAlias[255 + 1]

Псевдоним iSCSI узла инициатора.

TargetName[223 + 1]

Имя целевого объекта iSCSI, с помощью которого необходимо установить сеанс входа.

Mappings

Структура ISCSI_TargetMapping , которая сопоставляет коллекцию логических номеров единиц (LUN), которые локально определены, с группой 64-разрядных номеров LUN iSCSI. Если служба инициатора не задает сопоставления, драйвер мини-порта HBA может использовать любые сопоставления для LUN. Драйвер мини-порта должен сообщить о несопоставленных LUN драйверу порта для перечисления.

Key[1]

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