ONEX_CONNECTION_PROFILE 結構
ONEX_CONNECTION_PROFILE結構包含目前用於 802.1X 驗證之 802.1X 連線設定檔的相關資訊。
語法
typedef struct _ONEX_CONNECTION_PROFILE {
DWORD dwVersion;
DWORD dwTotalLen;
DWORD fOneXSupplicantFlags :1;
DWORD fsupplicantMode :1;
DWORD fauthMode :1;
DWORD fHeldPeriod :1;
DWORD fAuthPeriod :1;
DWORD fStartPeriod :1;
DWORD fMaxStart :1;
DWORD fMaxAuthFailures :1;
DWORD fNetworkAuthTimeout :1;
DWORD fAllowLogonDialogs :1;
DWORD fNetworkAuthWithUITimeout :1;
DWORD fUserBasedVLan :1;
DWORD dwOneXSupplicantFlags;
ONEX_SUPPLICANT_MODE supplicantMode;
ONEX_AUTH_MODE authMode;
DWORD dwHeldPeriod;
DWORD dwAuthPeriod;
DWORD dwStartPeriod;
DWORD dwMaxStart;
DWORD dwMaxAuthFailures;
DWORD dwNetworkAuthTimeout;
DWORD dwNetworkAuthWithUITimeout;
BOOL bAllowLogonDialogs;
BOOL bUserBasedVLan;
} ONEX_CONNECTION_PROFILE, *PONEX_CONNECTION_PROFILE;
成員
-
dwVersion
-
這個 ONEX_CONNECTION_PROFILE 結構的版本。
-
dwTotalLen
-
這個 ONEX_CONNECTION_PROFILE 結構的長度，以位元組為單位。
-
fOneXSupplicantFlags
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 dwOneXSupplicantFlags 成員中的有效資料。
-
fsupplicantMode
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 supplicantMode 成員中的有效資料。
-
fauthMode
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 authMode 成員中的有效資料。
-
fHeldPeriod
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 dwHeldPeriod 成員中的有效資料。
-
fAuthPeriod
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 dwAuthPeriod 成員中的有效資料。
-
fStartPeriod
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 dwStartPeriod 成員中的有效資料。
-
fMaxStart
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 dwMaxStart 成員中的有效資料。
-
fMaxAuthFailures
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 dwMaxAuthFailures 成員中的有效資料。
-
fNetworkAuthTimeout
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 dwNetworkAuthTimeout 成員中的有效資料。
-
fAllowLogonDialogs
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 bAllowLogonDialogs 成員中的有效資料。
-
fNetworkAuthWithUITimeout
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 dwNetworkAuthWithUITimeout 成員中的有效資料。
-
fUserBasedVLan
-
指出 ONEX_CONNECTION_PROFILE 結構是否包含 bUserBasedVLan 成員中的有效資料。
-
dwOneXSupplicantFlags
-
設定檔中可存在的一組 802.1X 旗標。 這些旗標會保留供 802.1X 驗證模組內部使用。
-
supplicantMode
-
802.1X 架構中的 supplicantMode 元素，指定用於EAPOL-Start訊息的傳輸方法。 如需詳細資訊，請參閱 802.1X 配置中的 supplicantMode (OneX) 元素 。
值 意義 - OneXSupplicantModeInhibitTransmission
- 0
不會傳輸訊息EAPOL-Start。 僅適用于有線 LAN 設定檔。 - OneXSupplicantModeLearn
- 1
用戶端會根據網路功能判斷何時傳送EAPOL-Start封包。 只有在需要時，才會傳送EAPOL-Start訊息。 僅適用于有線 LAN 設定檔。 - OneXSupplicantModeCompliant
- 2
EAPOL-Start訊息會以 802.1X 指定的方式傳輸。 適用于有線和無線區域網路 設定檔。 -
authMode
-
802.1X 架構中的 authMode 元素，指定用於 802.1X 驗證的認證類型。 如需詳細資訊，請參閱 802.1X 配置中的 authMode (OneX) 元素 。
值 意義 - OneXAuthModeMachineOrUser
- 0
使用電腦或使用者認證。 登入使用者時，會使用使用者的認證進行驗證。 未登入使用者時，會使用電腦認證。 - OneXAuthModeMachineOnly
- 1
僅使用電腦認證。 - OneXAuthModeUserOnly
- 2
僅使用使用者認證。 - OneXAuthModeGuest
- 3
僅使用來賓 (空白) 認證。 - OneXAuthModeUnspecified
- 4
未指定要使用的認證。 -
dwHeldPeriod
-
802.1X 架構中的 heldPeriod 元素，指定失敗的驗證嘗試之後，用戶端不會在嘗試驗證失敗後重新嘗試驗證的時間長度，以秒為單位。 如需詳細資訊，請參閱 802.1X 配置中的 heldPeriod (OneX) 元素 。
-
dwAuthPeriod
-
802.1X 架構中的 authPeriod 元素，指定用戶端等候驗證器回應的時間長度上限，以秒為單位。 如果未在指定的期間內收到回應，用戶端會假設網路上沒有驗證器。 如需詳細資訊，請參閱 802.1X 配置中的 authPeriod (OneX) 元素 。
-
dwStartPeriod
-
802.1X 架構中的 startPeriod 元素，指定傳送EAPOL-Start之前所要等候的時間長度，以秒為單位。 傳送EAPOL-Start訊息以啟動 802.1X 驗證程式。 如需詳細資訊，請參閱 802.1X 配置中的 startPeriod (OneX) 元素 。
-
dwMaxStart
-
802.1X 架構中的 maxStart 元素，指定所傳送訊息的最大數目EAPOL-Start。 傳送EAPOL-Start訊息數目上限之後，用戶端會假設網路上沒有驗證器。 如需詳細資訊，請參閱 802.1X 配置中的 maxStart (OneX) 元素 。
-
dwMaxAuthFailures
-
802.1X 架構中的 maxAuthFailures 元素，指定一組認證允許的驗證失敗數目上限。 如需詳細資訊，請參閱 802.1X 架構中的 maxAuthFailures (OneX) 元素。
-
dwNetworkAuthTimeout
-
在正常登入繼續進行之前，等待 802.1X 驗證完成的時間，以秒為單位。 此值用於單一登入 (SSO) 案例。 此值預設為 802.1X 設定檔中的 10 秒。 如需詳細資訊，請參閱 802.1X 架構中的 maxDelay (singleSignOn) 元素 。
-
dwNetworkAuthWithUITimeout
-
在每次登入 SSO 期間顯示需要使用者輸入的使用者介面對話方塊時，等候連線的持續時間上限，以秒為單位。
在具有 SP1 和更新版本的 Windows Vista 上，此值會硬式編碼為 10 分鐘，而且無法設定。 在 Windows Vista 發行至製造版上，此值在 802.1X 設定檔中預設為 60 秒，並由架構中的 maxDelayWithAdditionalDialogs 元素控制。
在具有 SP1 和更新版本的 Windows Vista 上，會忽略 802.1X 架構中的 maxDelayWithAdditionalDialogs 元素，並已被取代。
-
bAllowLogonDialogs
-
值，指定在使用登入前 SSO 時是否允許顯示 EAP 對話方塊。 如需詳細資訊，請參閱 802.1X 架構中的 allowAdditionalDialogs 元素。
-
bUserBasedVLan
-
802.1X 架構中的 userBasedVirtualLan 元素，指定裝置使用的虛擬 LAN (VLAN) 會根據使用者的認證而變更。 某些網路存取伺服器 (NAS) 裝置會在使用者驗證之後變更 VLAN。 當 userBasedVirtualLan 為 TRUE 時，NAS 可能會在使用者驗證之後變更裝置的 VLAN。 如需詳細資訊，請參閱 802.1X 架構中的 userBasedVirtualLan (singleSignOn) Element 。
備註
ONEX_CONNECTION_PROFILE結構是由 802.1X 模組所使用，這是 Windows Vista 和更新版本上支援的新無線組態元件。
ONEX_RESULT_UPDATE_DATA包含狀態變更為 802.1X 驗證的資訊。 當WLAN_NOTIFICATION_DATA結構的NotificationSource成員WLAN_NOTIFICATION_SOURCE_ONEX，而所接收通知之WLAN_NOTIFICATION_DATA結構的NotificationCode成員為OneXNotificationTypeResultUpdate時，就會傳回ONEX_RESULT_UPDATE_DATA結構。 針對此通知，WLAN_NOTIFICATION_DATA結構的pData成員會指向包含 802.1X 驗證狀態變更資訊的ONEX_RESULT_UPDATE_DATA結構。
如果已設定ONEX_RESULT_UPDATE_DATA結構中的fOneXAuthParams成員，則ONEX_RESULT_UPDATE_DATA結構的authParams成員包含ONEX_VARIABLE_BLOB結構，內嵌ONEX_AUTH_PARAMS結構，從ONEX_VARIABLE_BLOB的 dwOffset成員開始。 ONEX_AUTH_PARAMS結構的oneXConnProfile成員包含ONEX_VARIABLE_BLOB結構，內嵌ONEX_CONNECTION_PROFILE結構，從ONEX_VARIABLE_BLOB的 dwOffset成員開始。
ONEX_CONNECTION_PROFILE結構未定義于公用標頭檔中。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2008 [僅限傳統型應用程式] |
另請參閱