структура 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, который предоставляет целевой объект. Протокол iSCSI использует TSID вместе с ISID для идентификации сеанса. Не путайте TSID с идентификатором сеанса, указанным UniqueSessionId .

ISID[6]

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

InitialR2t

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

ImmediateData

Логическое значение, указывающее, согласились ли инициатор и целевой объект разрешить передачу немедленных данных в сеансе. (Немедленные данные — это данные, которые инициатор выполняет обратно в PDU команды iSCSI.) Если этот элемент имеет значение TRUE, инициатор и целевой объект согласились разрешить передачу немедленных данных в этом сеансе.

Type

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

Тип Значение
discoverySession Сеанс используется только для обнаружения.
informationtalSession Сеанс используется для ограниченного набора команд SCSI.
dataSession Сеанс используется в качестве полнофункциональный сеанс.
bootSession Сеанс используется для загрузки из целевого объекта.

DataSequenceInOrder

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

Значение в DataSequenceInOrder указывает на упорядочение самих последовательностей, а не порядок PKU данных в каждой последовательности. Элемент DataPduInOrder указывает порядок единиц обработки данных в каждой последовательности.

DataPduInOrder

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

ErrorRecoveryLevel

Уровень восстановления ошибок, согласованный инициатором и целевым объектом. Более высокие цифры представляют собой более сложные схемы восстановления. В настоящее время этот элемент должен иметь значение 0 или ULONG_VALUE_UNKNOWN.

MaxOutstandingR2t

Максимальное количество невыполненных запросов на передачу (R2T), разрешенных для каждой задачи в рамках этого сеанса.

FirstBurstLength

Максимальный объем нежелательных данных в байтах, которые можно отправить в рамках этого сеанса.

MaxBurstLength

Максимальное число байтов, которое можно отправить в пределах одной последовательности Data-In или Data-Out PKU.

MaxConnections

Максимальное количество подключений, разрешенных в рамках этого сеанса.

ConnectionCount

Количество подключений, которые в настоящее время принадлежат этому сеансу.

ConnectionsList[1]

Массив переменной длины ISCSI_ConnectionStaticInfo структур, указывающий статические данные конфигурации для каждого подключения, связанного с этим сеансом. ConnectionCount указывает количество элементов в массиве.

Требования

Требование Значение
Заголовок iscsimgt.h (включая Iscsimgt.h)

См. также раздел

AddConnectionToSession

ISCSI_ConnectionStaticInfo

LOGINSESSIONTYPE

LoginToTarget