ISCSI_SessionStaticInfo结构(iscsimgt.h)
ISCSI_SessionStaticInfo结构提供有关 iSCSI 会话的特征的信息。
语法
typedef struct _ISCSI_SessionStaticInfo {
ULONGLONG UniqueSessionId;
WCHAR InitiatoriSCSIName[223 + 1];
WCHAR TargetiSCSIName[223 + 1];
USHORT TSID;
UCHAR ISID[6];
BOOLEAN InitialR2t;
BOOLEAN ImmediateData;
UCHAR Type;
BOOLEAN DataSequenceInOrder;
BOOLEAN DataPduInOrder;
UCHAR ErrorRecoveryLevel;
ULONG MaxOutstandingR2t;
ULONG FirstBurstLength;
ULONG MaxBurstLength;
ULONG MaxConnections;
USHORT ConnectionCount;
ISCSI_ConnectionStaticInfo ConnectionsList[1];
} ISCSI_SessionStaticInfo, *PISCSI_SessionStaticInfo;
成员
UniqueSessionId
唯一标识会话的 64 位整数。 LoginToTarget 和 AddConnectionToSession 方法均在其 UniqueSessionId 参数中返回此值。 不要将此值与 ISID 和 TSID 成员中的值混淆。
InitiatoriSCSIName[223 + 1]
一个指定发起程序节点名称的宽字符字符串。
TargetiSCSIName[223 + 1]
一个指定目标的节点名称的宽字符字符串。
TSID
一个内部值,该值指定目标提供的 iSCSI 会话 ID 部分。 iSCSI 协议将 TSID 与 ISID 一起使用来标识会话。 请勿将 TSID 与 UniqueSessionId 指定的会话 ID 混淆。
ISID[6]
一个内部值,该值指定发起程序提供的 iSCSI 会话 ID 部分。
InitialR2t
一个布尔值,该值指示发起程序在将数据发送到目标之前是否必须等待随时发送 (R2T) 请求。 如果此成员 TRUE,则发起程序必须在将数据发送到目标之前等待随时发送 (R2T) 请求。 如果此成员 FALSE,则发起程序可以在 firstBurstLength 的值所指定的 限制内发送未经请求的数据。
ImmediateData
一个布尔值,该值指示发起方和目标是否同意允许在会话中传输即时数据。 (即时数据 是发起程序在 iSCSI 命令 PDU 上的数据。如果此成员 TRUE,发起方和目标已同意允许在此会话中立即传输数据。
Type
一个指定登录会话类型的 ISCSI_SESSION_TYPE_QUALIFIERS 枚举值。
类型 | 意义 |
---|---|
discoverySession | 会话仅用于发现。 |
informationtalSession | 会话用于有限的一组 SCSI 命令。 |
dataSession | 会话正用作功能完整的会话。 |
bootSession | 会话用于从目标启动。 |
DataSequenceInOrder
一个布尔值,该值指示是否必须使用持续增加的偏移量(在错误恢复期间除外)传输数据 PDU 序列。 如果此成员 TRUE,则必须使用持续增加的偏移量(错误恢复期间除外)传输数据 PDU 序列。 如果此成员 FALSE,则可以按任意顺序传输数据 PDU 序列。
DataSequenceInOrder 中的值 指示序列本身的顺序,而不是每个序列中的数据 PDU 的排序。 DataPduInOrder 成员指示每个序列中数据 PDU 的顺序。
DataPduInOrder
一个布尔值,该值指示数据 PDU 序列中的数据 PDU 是否必须位于不断增加的地址。 如果此成员 TRUE,则数据 PDU 序列中的数据 PDU 必须位于不断增加的地址,且 PDU 之间没有差距或覆盖。 如果此成员 FALSE,则每个序列中的数据 PDU 可以按任意顺序排列。
ErrorRecoveryLevel
发起方和目标协商的错误恢复级别。 较高的数字表示更详细的恢复方案。 目前,此成员必须为 0 或ULONG_VALUE_UNKNOWN。
MaxOutstandingR2t
此会话中每个任务允许的最大未完成随时传输(R2T)请求数。
FirstBurstLength
可在此会话中发送的最大未请求数据量(以字节为单位)。
MaxBurstLength
可以在单个 Data-In 或 Data-Out PDU 序列内发送的最大字节数。
MaxConnections
此会话中允许的最大连接数。
ConnectionCount
当前属于此会话的连接数。
ConnectionsList[1]
ISCSI_ConnectionStaticInfo 结构的可变长度数组,指定与此会话关联的每个连接的静态配置数据。 ConnectionCount 指示数组中的元素数。
要求
要求 | 价值 |
---|---|
标头 | iscsimgt.h (包括 Iscsimgt.h) |