ISCSI_LoginOptions 结构 (iscsidef.h)
ISCSI_LoginOptions 结构定义登录会话的特征。 LoginToTarget_IN例程在登录到 iSCSI 目标时使用这些定义的特征。
语法
typedef struct _ISCSI_LoginOptions {
ULONG InformationSpecified;
ULONG HeaderDigest;
ULONG DataDigest;
ULONG MaximumConnections;
ULONG DefaultTime2Wait;
ULONG DefaultTime2Retain;
ULONG LoginFlags;
ULONG AuthType;
} ISCSI_LoginOptions, *PISCSI_LoginOptions;
成员
InformationSpecified
一个位图,指示ISCSI_LoginOptions结构的哪些成员包含有效数据。 下表描述了可能的值:
bit | 说明 |
---|---|
ISCSI_LOGIN_OPTIONS_HEADER_DIGEST | HeaderDigest 成员指定用于保证标头数据完整性的摘要的类型。 |
ISCSI_LOGIN_OPTIONS_DATA_DIGEST | DataDigest 成员指定用于保证标头数据完整性的摘要的类型。 |
ISCSI_LOGIN_OPTIONS_MAXIMUM_CONNECTIONS | MaximumConnections 成员指定 iSCSI 会话中允许的最大连接数。 |
ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_WAIT | DefaultTime2Wait 成员指定发起方尝试重新连接或重新分配已删除的连接之前等待的最短时间(以秒为单位)。 |
ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_RETAIN | DefaultTime2Retain 成员指定在 DefaultTime2Wait 中指示的初始等待后允许重新分配命令的最长时间。 |
ISCSI_LOGIN_OPTIONS_AUTH_TYPE | AuthType 成员指定建立登录会话的身份验证类型。 |
ISCSI_LOGIN_OPTIONS_USERNAME | 登录期间要使用的用户名。 |
ISCSI_LOGIN_OPTIONS_PASSWORD | 登录期间要使用的密码。 |
HeaderDigest
一个 ISCSI_DIGEST_TYPES 值,该值指示发起方用于验证登录 PDU 中标头摘要完整性的方法。
DataDigest
一个 ISCSI_DIGEST_TYPES 值,该值指示发起方用于验证登录 PDU 中数据摘要的完整性的方法。
MaximumConnections
一个介于 1 和 65535 之间的值,指定可与单个登录会话关联的目标设备的最大连接数。 值为 0 表示连接数没有限制。
DefaultTime2Wait
发起方尝试重新连接或重新分配在意外终止或重置连接后删除 (或任务) 之前等待的最短时间(以秒为单位)。 发起方和目标协商以确定此值。
DefaultTime2Retain
在 DefaultTime2Wait 中指示的初始等待过后重新分配连接的最长时间(以秒为单位)。 发起方和目标协商以确定此值。
LoginFlags
定义登录会话的某些特征的登录标志的按位 OR。 下表指示可以分配给此成员的值。
登录标志 | 含义 |
---|---|
ISCSI_LOGIN_FLAG_REQUIRE_IPSEC | 登录会话必须使用 IPSec 协议。 |
ISCSI_LOGIN_FLAG_MULTIPATH_ENABLED | 安装了多路径软件,因此 iSCSI 发起程序服务允许与同一目标建立多个会话。 |
ISCSI_LOGIN_FLAG_RESERVED1 | 仅供 Microsoft 内部使用。 |
ISCSI_LOGIN_FLAG_ALLOW_PORTAL_HOPPING | 如果目标门户不可用于登录,则发起程序可以通过它发现并可用于登录操作的目标门户列表进行“跳跃”。 也就是说,发起程序将继续尝试可用的门户列表,直到找到可用于登录的门户,以便可以登录到可用的目标门户。 |
ISCSI_LOGIN_FLAG_USE_RADIUS_RESPONSE | 使用 RADIUS 生成 CHAP 响应。 |
ISCSI_LOGIN_FLAG_USE_RAIDUS_VERIFICATION | 使用 RADIUS 验证 CHAP 响应。 |
AuthType
ISCSI_AUTH_TYPES值,该值指示用于建立登录连接的身份验证方法。
要求
要求 | 值 |
---|---|
Header | iscsidef.h (包括 Iscsidef.h) |