DOT11EXT_ONEX_START回调函数 (wlanihv.h)

项目
05/23/2024

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。请改用 WLAN 设备驱动程序接口 (WDI) 。有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

IHV 扩展 DLL 调用 Dot11ExtStartOneX 函数，以使用接入点 (AP) 启动 802.1X 身份验证操作。在这种情况下，身份验证由 Native 802.11 框架的 802.1X 模块管理，而不是由 IHV 扩展 DLL 管理。

语法

DOT11EXT_ONEX_START Dot11extOnexStart;

DWORD Dot11extOnexStart(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}

参数

[in, optional] hDot11SvcHandle

操作系统用于引用无线 LAN (WLAN) 适配器的句柄。此句柄值是通过之前对 Dot11ExtIhvInitAdapter IHV 处理程序函数的调用指定的。

[in, optional] pEapAttributes

指向包含身份验证会话返回的 EAP 属性的EAP_ATTRIBUTES数组结构的指针。有关EAP_ATTRIBUTES的详细信息，请参阅Microsoft Windows SDK文档。

返回值

如果调用成功，函数将返回ERROR_SUCCESS。否则，它将返回 Winerror.h 中定义的错误代码。

注解

IHV 扩展 DLL 可以使用本机 802.11 框架的 802.1X 模块启动 802.1X 身份验证操作。这允许 DLL 使用标准可扩展身份验证协议 (EAP) 操作系统支持的算法。

IHV 扩展 DLL 通过调用 Dot11ExtStartOneX 函数启动 802.1X 身份验证操作。 Dot11ExtStartOneX 只能在关联后操作期间或操作完成后调用。有关此操作的详细信息，请参阅关联后操作。

调用 Dot11ExtStartOneX 函数时，操作系统将 EAP 通过 LAN (EAPOL) Start 数据包发送到 AP。如果 AP 在 EAPOL-Start 数据包的三次传输后无法响应，则操作系统将失败 802.1X 身份验证操作并调用 Dot11ExtIhvOneXIndicateResult IHV 处理程序函数。有关 EAPOL-Start 数据包的详细信息，请参阅 IEEE 802.1X-1999 标准的条款 7.5 和条款 8.4.2。

启动 802.1X 身份验证操作后，IHV 扩展 DLL 必须遵循以下准则。

IHV 扩展必须将所有 EAPOL 数据包转发到操作系统进行处理。当 DLL 通过调用 Dot11ExtIhvReceivePacket IHV 处理程序函数接收 EAPOL 数据包时，DLL 必须调用 Dot11ExtProcessOneXPacket 以将数据包转发到操作系统。
有关 EAPOL 数据包的详细信息，请参阅 IEEE 802.1X-2001 标准的第 7 条。

注意 IHV 扩展 DLL 负责处理 EAPOL-Key 数据包，不得将这些数据包转发到操作系统。
完成 802.1X 身份验证操作后，操作系统会调用 Dot11ExtIhvOneXIndicateResult 用于指示正在进行授权的 IHV 处理程序函数。
IHV 扩展 DLL 可以通过调用 Dot11ExtStopOneX 来取消 802.1X 身份验证操作。

有关使用 802.1X 模块进行身份验证的详细信息，请参阅 Native 802.11 802.1X 模块的接口。

要求

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台	桌面
标头	wlanihv.h (包括 Wlanihv.h)