dot1x.h) (ONEX_AUTH_PARAMS 结构

项目
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_BLOB的dwOffset 成员开始的嵌入 ONEX_CONNECTION_PROFILE结构。

authIdentity

用于 802.1X 身份验证状态的标识。此成员是 ONEX_AUTH_IDENTITY 枚举中的值。

dwQuarantineState

本地计算机的隔离状态值。隔离状态决定了其网络连接。此成员对应于 EAPHost ISOLATION_STATE 枚举中的值。

fSessionId

指示 ONEX_AUTH_PARAMS 结构是否在 dwSessionId 成员中包含会话 ID。

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

当前登录到主机的用户的会话 ID。此成员对应于 WTSGetActiveConsoleSessionId 函数返回的值。如果设置了 fSessionId 位域成员，则此成员包含会话 ID。

hUserToken

用于 802.1X 身份验证的用户令牌句柄。如果设置了 fhUserToken 位域成员，则此成员包含用户令牌句柄。

出于安全原因，ONEX_RESULT_UPDATE_DATA 结构的 authParams 成员中返回的 ONEX_AUTH_PARAMS 结构的 hUserToken 成员始终设置为 NULL。

OneXUserProfile

用于 802.1X 身份验证的 802.1X 用户配置文件。如果设置了 fOneXUserProfile 位域成员，则此成员包含从 ONEX_VARIABLE_BLOB的 dwOffset 成员开始的嵌入式用户配置文件。

出于安全原因，ONEX_RESULT_UPDATE_DATA 结构的 authParams 成员中返回的 ONEX_AUTH_PARAMS 结构的 OneXUserProfile 成员始终设置为 NULL。

Identity

用于 802.1X 身份验证的 802.1X 标识。如果设置了 fIdentity 位域成员，则此成员包含以 NULL 结尾的 Unicode 字符串，该字符串的标识从 ONEX_VARIABLE_BLOB的 dwOffset 成员开始。

UserName

用于 802.1X 身份验证的用户名。如果设置了 fUserName 位字段成员，则此成员包含以 NULL 结尾的 Unicode 字符串，其用户名从 ONEX_VARIABLE_BLOB的 dwOffset 成员开始。

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_VARIABLE_BLOB的 dwOffset 成员开始嵌入ONEX_AUTH_PARAMS结构。

出于安全原因，authParams 成员中返回的 ONEX_AUTH_PARAMS 结构的 hUserToken 和 OneXUserProfile 成员始终设置为 NULL。