共用方式為

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 [僅限傳統型應用程式]

另請參閱

關於 ACM 架構

OneX 架構

authMode (OneX) 元素

authPeriod (OneX) 元素

heldPeriod (OneX) 元素

maxAuthFailures (OneX)

maxStart (OneX) 元素

startPeriod (OneX) 元素

supplicantMode (OneX) 元素

userBasedVirtualLan (singleSignOn) 元素

ONEX_AUTH_PARAMS

ONEX_NOTIFICATION_TYPE

ONEX_RESULT_UPDATE_DATA

OneX 架構元素

ONEX_VARIABLE_BLOB

WLAN_NOTIFICATION_DATA

WlanRegisterNotification