DOT11EXTIHV_PERFORM_POST_ASSOCIATE回调函数（wlanihv.h）

项目
02/07/2025

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

作系统调用 Dot11ExtIhvPerformPostAssociate 函数，以请求 IHV 扩展 DLL 启动与基本服务集（BSS）网络的关联后作。

语法

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

参数

[in, optional] hIhvExtAdapter

IHV 扩展 DLL 用于引用无线 LAN （WLAN）适配器的句柄。此句柄值是通过上一次调用 Dot11ExtIhvInitAdapter IHV 处理程序函数指定的。

[in, optional] hSecuritySessionID

安全会话的句柄。调用 IHV 扩展 DLL 时必须使用此句柄值 Dot11ExtPostAssociateCompletion 异步完成关联后作。

[in] pPortState

指向 DOT11_PORT_STATE 结构的指针，该结构指定安全会话的当前端口状态。

[in] uDot11AssocParamsBytes

通过 pDot11AssocParams 参数引用的数据的长度（以字节为单位）。

[in] pDot11AssocParams

指向 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 结构，该结构指定 WLAN 适配器完成的关联作的结果。管理 WLAN 适配器的 Native 802.11 微型端口驱动程序在生成媒体特定时包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS结构 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 指示。

有关关联作的详细信息，请参阅关联作。

返回值

如果 IHV 扩展 DLL 可以启动关联后作，则必须异步完成该作。在这种情况下，该函数返回ERROR_SUCCESS。

如果 IHV 扩展 DLL 无法启动关联后作，它将返回在 Winerror.h中定义的错误代码。

言论

作系统调用 Dot11ExtIhvPerformPostAssociate 函数来启动与 IHV 扩展 DLL 的关联后作。在 WLAN 适配器完成与基础结构基本服务集（BSS）网络中的接入点（AP）的关联作后，作系统将启动此作。

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

有关关联作的详细信息，请参阅关联作。

从调用 dot11ExtIhvPerformPostAssociate ，必须异步完成关联后作。关联后作完成后，DLL 必须调用 Dot11ExtPostAssociateCompletion。

如果 IHV 扩展 DLL 可以启动关联后作，Dot11ExtIhvPerformPostAssociate 函数必须返回ERROR_SUCCESS并异步完成该作。

有关关联后作的详细信息，请参阅关联后作。

要求

要求	价值
最低支持的客户端	在 Windows Vista 和更高版本的 Windows作系统中可用。
目标平台	桌面
标头	wlanihv.h（包括 Wlanihv.h、Windot11.h、L2cmn.h）