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 列挙値。
| Type | 説明 |
|---|---|
| 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 の 1 つのシーケンス内で送信できる最大バイト数。
MaxConnections
このセッション内で許可される接続の最大数。
ConnectionCount
このセッションに現在属している接続の数。
ConnectionsList[1]
このセッションに関連付けられている各接続の静的構成データを指定する、 ISCSI_ConnectionStaticInfo 構造体の可変長配列。 ConnectionCount は、配列内の要素の数を示します。
要件
| 要件 | 値 |
|---|---|
| Header | iscsimgt.h (Iscsimgt.h を含む) |