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 位整数。 LoginToTargetAddConnectionToSession 方法都在其 UniqueSessionId 参数中返回此值。 请勿将此值与 ISIDTSID 成员中的值混淆。

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 指示数组中的元素数。

要求

要求
Header iscsimgt.h (包括 Iscsimgt.h)

另请参阅

AddConnectionToSession

ISCSI_ConnectionStaticInfo

LOGINSESSIONTYPE

LoginToTarget