ONEX_AUTH_PARAMS 結構 (dot1x.h)

發行項
08/23/2023

ONEX_AUTH_PARAMS結構包含用於 802.1X 驗證的 802.1X 驗證參數。

語法

typedef struct _ONEX_AUTH_PARAMS {
  BOOL               fUpdatePending;
  ONEX_VARIABLE_BLOB oneXConnProfile;
  ONEX_AUTH_IDENTITY authIdentity;
  DWORD              dwQuarantineState;
  DWORD              fSessionId : 1;
  DWORD              fhUserToken : 1;
  DWORD              fOnexUserProfile : 1;
  DWORD              fIdentity : 1;
  DWORD              fUserName : 1;
  DWORD              fDomain : 1;
  DWORD              dwSessionId;
  HANDLE             hUserToken;
  ONEX_VARIABLE_BLOB OneXUserProfile;
  ONEX_VARIABLE_BLOB Identity;
  ONEX_VARIABLE_BLOB UserName;
  ONEX_VARIABLE_BLOB Domain;
} ONEX_AUTH_PARAMS, *PONEX_AUTH_PARAMS;

成員

fUpdatePending

指出 802.X 驗證的狀態更新是否擱置中。

oneXConnProfile

802.1X 驗證連線設定檔。此成員包含從ONEX_VARIABLE_BLOBdwOffset成員開始的內嵌ONEX_CONNECTION_PROFILE結構。

authIdentity

用於 802.1X 驗證狀態的身分識別。這個成員是來自ONEX_AUTH_IDENTITY 列舉的值。

dwQuarantineState

本機電腦的隔離隔離狀態值。隔離狀態會決定其網路連線能力。這個成員會對應至 EAPHost ISOLATION_STATE 列舉中的值。

fSessionId

指出 ONEX_AUTH_PARAMS 結構是否包含 dwSessionId 成員中的會話識別碼。

fhUserToken

指出 ONEX_AUTH_PARAMS 結構是否包含 hUserToken 成員中的使用者權杖控制碼。

基於安全性考慮，在ONEX_RESULT_UPDATE_DATA結構的authParams成員中傳回之ONEX_AUTH_PARAMS結構的hUserToken成員一律會設定為Null。

fOnexUserProfile

指出 ONEX_AUTH_PARAMS 結構是否包含 OneXUserProfile 成員中的 802.1X 使用者設定檔。

基於安全性考慮，ONEX_RESULT_UPDATE_DATA 結構的authParams成員中所傳回之ONEX_AUTH_PARAMS結構的OneXUserProfile成員一律會設定為Null。

fIdentity

指出 ONEX_AUTH_PARAMS 結構是否包含 Identity 成員中的 802.1X 身分識別 。

fUserName

指出 ONEX_AUTH_PARAMS 結構是否包含 UserName 成員中用於 802.1X 驗證的使用者名稱。

fDomain

指出 ONEX_AUTH_PARAMS 結構是否包含網域成員中用於 802.1X 驗證的網域。

dwSessionId

目前登入主控台之使用者的會話識別碼。此成員會對應至 WTSGetActiveConsoleSessionId 函式所傳回的值。如果 已設定 fSessionId 位欄位成員，此成員就會包含會話識別碼。

hUserToken

用於 802.1X 驗證的使用者權杖控制碼。如果 設定 fhUserToken bitfield 成員，此成員會包含使用者權杖控制碼。

基於安全性考慮，在ONEX_RESULT_UPDATE_DATA結構的authParams成員中傳回之ONEX_AUTH_PARAMS結構的hUserToken成員一律會設定為Null。

OneXUserProfile

用於 802.1X 驗證的 802.1X 使用者設定檔。如果設定 fOneXUserProfile bitfield 成員，此成員包含從ONEX_VARIABLE_BLOBdwOffset成員開始的內嵌使用者設定檔。

基於安全性考慮，ONEX_RESULT_UPDATE_DATA 結構的authParams成員中所傳回之ONEX_AUTH_PARAMS結構的OneXUserProfile成員一律會設定為Null。

Identity

用於 802.1X 驗證的 802.1X 身分識別。如果已設定 fIdentity bitfield 成員，此成員包含 Null 終止的 Unicode 字串，其身分識別是從ONEX_VARIABLE_BLOBdwOffset成員開始。

UserName

用於 802.1X 驗證的使用者名稱。如果已設定 fUserName bitfield 成員，此成員包含以 Null 終止的 Unicode 字串，該字串的使用者名稱是從ONEX_VARIABLE_BLOBdwOffset成員開始。

Domain

用於 802.1X 驗證的網域。如果已設定 fDomain位欄位成員，此成員包含 Null 終止的 Unicode 字串，且網域從ONEX_VARIABLE_BLOB的 dwOffset成員開始。

備註

ONEX_AUTH_PARAMS結構是由 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成員開始。

基於安全性考慮，authParams成員中傳回之ONEX_AUTH_PARAMS結構的hUserToken和OneXUserProfile成員一律會設定為Null。

需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	dot1x.h