iscsidef.h) ISCSI_LoginOptions 結構 (
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
定義登入會話特定特性的登入旗標位 OR。 下表指出您可以指派給這個成員的值。
| 登入旗標 | 意義 |
|---|---|
| ISCSI_LOGIN_FLAG_REQUIRE_IPSEC | 登入會話必須使用IPSec通訊協定。 |
| ISCSI_LOGIN_FLAG_MULTIPATH_ENABLED | 已安裝多重路徑軟體，因此 iSCSI 啟動器服務允許相同目標的多個工作階段。 |
| ISCSI_LOGIN_FLAG_RESERVED1 | 僅供 Microsoft 內部使用。 |
| 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) |