ONEX_REASON_CODE 枚举 (dot1x.h)

项目
08/23/2023

ONEX_REASON_CODE枚举类型指定指示 802.1X 身份验证失败原因的可能值。

语法

typedef enum _ONEX_REASON_CODE {
  ONEX_REASON_CODE_SUCCESS = 0,
  ONEX_REASON_START,
  ONEX_UNABLE_TO_IDENTIFY_USER,
  ONEX_IDENTITY_NOT_FOUND,
  ONEX_UI_DISABLED,
  ONEX_UI_FAILURE,
  ONEX_EAP_FAILURE_RECEIVED,
  ONEX_AUTHENTICATOR_NO_LONGER_PRESENT,
  ONEX_NO_RESPONSE_TO_IDENTITY,
  ONEX_PROFILE_VERSION_NOT_SUPPORTED,
  ONEX_PROFILE_INVALID_LENGTH,
  ONEX_PROFILE_DISALLOWED_EAP_TYPE,
  ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG,
  ONEX_PROFILE_INVALID_ONEX_FLAGS,
  ONEX_PROFILE_INVALID_TIMER_VALUE,
  ONEX_PROFILE_INVALID_SUPPLICANT_MODE,
  ONEX_PROFILE_INVALID_AUTH_MODE,
  ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES,
  ONEX_UI_CANCELLED,
  ONEX_PROFILE_INVALID_EXPLICIT_CREDENTIALS,
  ONEX_PROFILE_EXPIRED_EXPLICIT_CREDENTIALS,
  ONEX_UI_NOT_PERMITTED
} ONEX_REASON_CODE, PONEX_REASON_CODE;

常量


`ONEX_REASON_CODE_SUCCESS` 值： 0 指示 802.1X 身份验证成功。
`ONEX_REASON_START` 指示指定 802.1X 原因代码的可能值的范围的开头。
`ONEX_UNABLE_TO_IDENTIFY_USER` 802.1X 模块无法识别要使用的一组凭据。例如，身份验证模式设置为用户，但没有用户登录。
`ONEX_IDENTITY_NOT_FOUND` EAP 模块无法获取用户的标识。因此，当前未使用值。所有特定于 EAP 的错误都作为 ONEX_EAP_FAILURE_RECEIVED返回。
`ONEX_UI_DISABLED` 若要继续执行 802.1X 身份验证，系统需要请求用户输入，但用户界面已禁用。在 Windows Vista 和 Windows Server 2008 上，如果 EAP 方法请求用户输入用于来宾或本地计算机身份验证的配置文件，则可以返回此值。在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上，不应返回此值。
`ONEX_UI_FAILURE` 802.1X 身份验证模块无法返回请求的用户输入。在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上，如果 EAP 方法请求用户输入，但无法显示 UI， (网络图标配置为不显示在任务栏中，例如) 。
`ONEX_EAP_FAILURE_RECEIVED` EAP 模块返回了错误代码。 ONEX_EAP_ERROR 结构可能包含有关找不到证书 (特定 EAP 错误的其他信息，例如) 。
`ONEX_AUTHENTICATOR_NO_LONGER_PRESENT` 与 802.1X 模块协商的对等机不再存在，或者 (笔记本电脑客户端移出无线接入点的范围（例如) ）时没有响应。
`ONEX_NO_RESPONSE_TO_IDENTITY` 未收到 EAP 标识响应数据包的响应。此值表示基础结构 (无线接入点与身份验证服务器之间的链接无法正常工作，例如) 。
`ONEX_PROFILE_VERSION_NOT_SUPPORTED` 802.1X 模块不支持此版本的配置文件。
`ONEX_PROFILE_INVALID_LENGTH` 802.1X 配置文件中指定的 length 成员无效。
`ONEX_PROFILE_DISALLOWED_EAP_TYPE` 此媒体不允许使用 802.1X 配置文件中指定的 EAP 类型。例如，将键式 MD5 算法用于无线传输。
`ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG` 802.1X 配置文件中指定的 EAP 类型或 EAP 标志无效。例如，系统未安装 EAP 类型。
`ONEX_PROFILE_INVALID_ONEX_FLAGS` 802.1X 配置文件中指定的 802.1X 标志无效。
`ONEX_PROFILE_INVALID_TIMER_VALUE` 802.1X 配置文件中指定的一个或多个计时器值已超过其有效范围。
`ONEX_PROFILE_INVALID_SUPPLICANT_MODE` 802.1X 配置文件中指定的请求模式无效。
`ONEX_PROFILE_INVALID_AUTH_MODE` 802.1X 配置文件中指定的身份验证模式无效。
`ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES` 802.1X 配置文件中指定的 EAP 连接属性无效。
`ONEX_UI_CANCELLED` 用户输入已取消。如果 EAP 方法请求用户输入，但用户点击“取消”按钮或关闭了用户输入对话框，则可以返回此值。在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上支持此值。
`ONEX_PROFILE_INVALID_EXPLICIT_CREDENTIALS` 保存的用户凭据无效。如果保存配置文件时使用了错误的凭据 (不正确的密码（例如，) ），则可能会返回此值，因为在配置文件实际用于建立连接之前，不会测试凭据。在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上支持此值。
`ONEX_PROFILE_EXPIRED_EXPLICIT_CREDENTIALS` 保存的用户凭据已过期。如果配置文件是使用凭据保存的，并且凭据随后在一段时间后过期 (密码过期，例如) ，则可以返回此值。在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上支持此值。
`ONEX_UI_NOT_PERMITTED` 不允许使用用户界面。在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上，如果 EAP 方法请求用户输入，并且配置文件使用另一个用户而不是当前登录的用户保存的用户凭据进行配置，则可以返回此值。在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上支持此值。

备注

ONEX_REASON_CODE枚举类型由 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 结构的 oneXStatus 成员包含 ONEX_STATUS 结构。如果在 802.1X 身份验证期间发生错误，则此 ONEX_STATUS 结构的 dwReason 成员包含指定为 ONEX_REASON_CODE 枚举中的值的错误的原因。