структура 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
Побитовое ИЛИ флагов входа, которые определяют определенные характеристики сеанса входа. В следующей таблице указаны значения, которые можно присвоить этому элементу.
| Флаг входа | Значение |
|---|---|
| ISCSI_LOGIN_FLAG_REQUIRE_IPSEC | Сеанс входа должен использовать протокол IPSec. |
| ISCSI_LOGIN_FLAG_MULTIPATH_ENABLED | Установлено программное обеспечение с несколькими точками, поэтому служба инициатора iSCSI позволяет использовать несколько сеансов к одному и тому же целевому объекту. |
| ISCSI_LOGIN_FLAG_RESERVED1 | Только для внутреннего использования в корпорации Майкрософт. |
| 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 , указывающее метод проверки подлинности, используемый для установки подключения к входу.
Требования
| Требование | Значение |
|---|---|
| Заголовок | iscsidef.h (включая Iscsidef.h) |