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構造体のメンバーを示すビットマップ。 次の表では、使用可能な値について説明します。
| ビット | 説明 |
|---|---|
| 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
イニシエーターがログオン PDU 内のヘッダー ダイジェストの整合性を検証するために使用する方法を示すISCSI_DIGEST_TYPES値。
DataDigest
イニシエーターがログオン PDU 内のデータ ダイジェストの整合性を検証するために使用する方法を示すISCSI_DIGEST_TYPES値。
MaximumConnections
1 つのログオン セッションに関連付けることができるターゲット デバイスへの接続の最大数を指定する 1 ~ 65535 の値。 値 0 は、接続の数に制限がないことを示します。
DefaultTime2Wait
イニシエーターが、予期しない接続の終了またはリセット後に切断された接続 (またはタスク) の再接続または再割り当てを試行するまでの最小待機時間 (秒単位)。 イニシエーターとターゲットは、この値を決定するためにネゴシエートします。
DefaultTime2Retain
DefaultTime2Wait に示されている最初の待機が経過した後に接続を再割り当てする最大時間 (秒単位)。 イニシエーターとターゲットは、この値を決定するためにネゴシエートします。
LoginFlags
ログオン セッションの特定の特性を定義するログオン フラグのビットごとの OR。 次の表は、このメンバーに割り当てることができる値を示しています。
| ログオン フラグ | 意味 |
|---|---|
| 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 値。
要件
| 要件 | 値 |
|---|---|
| Header | iscsidef.h (Iscsidef.h を含む) |