AddConnectionToSession_IN 結構 (iscsiop.h)

發行項
03/01/2024

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 欄位所指定。