(wlanihv.h) 的DOT11EXT_POST_ASSOCIATE_COMPLETION回调函数

项目
08/08/2023

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

IHV 扩展 DLL 调用 Dot11ExtPostAssociateCompletion 函数以异步方式完成通过调用启动的关联后操作 Dot11ExtIhvPerformPostAssociate IHV 处理程序函数。

语法

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

参数

[in, optional] hDot11SvcHandle

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

[in, optional] hSecuritySessionID

安全会话标识符 (ID) 通过上一次调用返回的句柄 Dot11ExtIhvPerformPostAssociate IHV 处理程序函数。

[in, optional] pPeer

媒体访问控制 (MAC) 地址的接入点 (AP) ，IHV 扩展 DLL 在其中执行安全操作。此参数的格式设置为 DOT11_MAC_ADDRESS 结构。

注意对于 Windows Vista，IHV 扩展 DLL 仅支持基础结构基本服务集 (BSS) 网络。

[in] dwReasonCode

一个值，该值提供关联后操作的完成状态的其他信息。 IHV 扩展 DLL 必须将 dwReasonCode 设置为 L2cmn.h 中定义的L2_REASON_CODE_xxxx值。

IHV 扩展 DLL 通过 dwWin32Error 参数返回关联后操作的常规完成状态。通常，IHV 扩展 DLL 将 dwReasonCode 设置为从 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 范围内的值。

[in] dwWin32Error

由 Winerror.h 中的错误代码定义的关联后操作的完成状态。如果操作成功完成，IHV 扩展 DLL 必须将 dwWin32Error 设置为 ERROR_SUCCESS。

返回值

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

注解

IHV 扩展 DLL 调用 Dot11ExtPostAssociateCompletion 函数以执行以下任一操作：

完成通过调用启动的关联后操作 Dot11ExtIhvPerformPostAssociate IHV 处理程序函数。
完成关联后操作后，指示 hSecuritySessionID 参数引用的安全会话的端口状态发生更改。
例如，如果端口的授权状态更改，IHV 扩展 DLL 可以通过调用 Dot11ExtPostAssociateCompletion 来通知操作系统。

调用 Dot11ExtPostAssociateCompletion 函数时，IHV 扩展 DLL 必须遵循这些准则。

如果关联后操作成功完成，IHV 扩展 DLL 必须将 dwReasonCode 设置为下列值之一：
- L2_REASON_CODE_SUCCESS。
- IHV 定义的值，范围从 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 。
在这种情况下，IHV 扩展 DLL 必须将 dwWin32Error 设置为 ERROR_SUCCESS。
注意如果 IHV 扩展 DLL 将 dwWin32Error 设置为 ERROR_SUCCESS，则操作系统将假定安全会话的端口状态处于授权状态。端口处于授权状态后，操作系统允许通过 WLAN 适配器发送所有数据包。
如果关联后操作以失败完成，IHV 扩展 DLL 不得将 dwReasonCode 设置为 L2_REASON_CODE_SUCCESS。相反，DLL 必须将 dwReasonCode 设置为下列值之一：
- 适当的L2_REASON_CODE_xxxx错误值。
- IHV 定义的值，范围从 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 。
在这种情况下，IHV 扩展 DLL 不得将 dwWin32Error 设置为 ERROR_SUCCESS。相反，DLL 必须将 dwWin32Error 设置为 Winerror.h 中定义的相应错误代码。
注意如果 IHV 扩展 DLL 未将 dwWin32Error 设置为 ERROR_SUCCESS，则操作系统将假定安全会话的端口状态处于未授权状态。端口处于未授权状态后，操作系统允许通过 WLAN 适配器发送安全数据包，包括通过 Dot11ExtSendPacket IHV 扩展函数发送的数据包。
每当调用 Dot11ExtIhvAdapterReset 或 Dot11ExtIhvDeinitAdapter IHV 处理程序函数时，IHV 扩展 DLL 必须调用 Dot11ExtPostAssociateCompletion 以取消所有挂起的关联后操作。在这种情况下，DLL 必须将 dwStatus 参数设置为 ERROR_CANCELLED。

要求

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