AddConnectionToSession_IN 结构 (iscsiop.h)

项目
02/29/2024

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

指示目标安全要求的标志的按位 OR。有关此成员可能值的列表，请参阅 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 字段指定。