ONEX_AUTH_PARAMS 結構 (dot1x.h)
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 |
另請參閱
ONEX_EAP_ERROR