AddConnectionToSession_IN 構造体 (iscsiop.h)

[アーティクル]
08/07/2023

AddConnectionToSession_IN構造体は AddConnectionToSession メソッドの入力データを保持します。これは、既存のセッションに新しい接続を追加するために使用されます。

構文

typedef struct _AddConnectionToSession_IN {
  ULONGLONG          UniqueAdapterId;
  ULONGLONG          UniqueSessionId;
  ULONGLONG          SecurityFlags;
  ULONG              PortNumber;
  ISCSI_LoginOptions LoginOptions;
  ISCSI_TargetPortal TargetPortal;
  ULONG              UsernameSize;
  ULONG              PasswordSize;
  ULONG              KeySize;
  UCHAR              Key[1];
} AddConnectionToSession_IN, *PAddConnectionToSession_IN;

メンバー

UniqueAdapterId

アダプターと、アダプターを管理する記憶域ミニポートドライバーの特定の読み込まれたインスタンスを一意に識別する 64 ビットの整数。この識別子は、アダプターが配置されているコンピューターだけでなく、ネットワーク全体でも一意です。

UniqueSessionId

セッションを一意に識別する 64 ビットの整数。 LoginToTarget メソッドと AddConnectionToSession メソッドはどちらも、UniqueSessionId パラメーターでこの値を返します。この値を ISID および TSID メンバーの値と混同しないでください。

SecurityFlags

ターゲットのセキュリティ要件を示すフラグのビットごとの OR。このメンバーに使用できる値の一覧については、「 SECURITY_FLAG_QUALIFIERS」を参照してください。

PortNumber

ターゲットログオンセッションを開始するポートの番号。

LoginOptions

接続が追加されるターゲットログオンセッションの特性を記述するISCSI_LoginOptions構造体。

TargetPortal

追加の接続を行うために使用するターゲットポータルを示す ISCSI_TargetPortal 構造。 AddConnectionToSession メソッドは、LoginToTarget メソッドを呼び出して新しい接続を確立します。 LoginToTarget がISCSC_TARGET_MOVED_PERMANENTLYまたはISCSC_TARGET_MOVED_TEMPORARILYのいずれかの状態値で失敗した場合。 TargetPortal は、 AddConnectionToSession からの出力時に、ログオン操作をリダイレクトする必要があるポータルを示します。 ISCSC_TARGET_MOVED_PERMANENTLYとISCSC_TARGET_MOVED_TEMPORARILYの状態の値の詳細については、「 ISCSI_STATUS_QUALIFIERS」を参照してください。

UsernameSize

ユーザー名のサイズ (バイト単位)。

PasswordSize

パスワードサイズ (バイト単位)。

KeySize

事前共有キーサイズ (バイト単位)。

Key[1]

ターゲット IP アドレスに関連付けられている事前共有キーを指定する文字の可変長配列。配列内の要素の数は、KeySize フィールドによって指定されます。