DOT11EXTIHV_PERFORM_POST_ASSOCIATE回调函数 (wlanihv.h)

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 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 适配器完成与接入点 (AP) 的关联操作后，操作系统将启动此操作，该接入点 (BSS) 网络。

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

 

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

必须在调用 Dot11ExtIhvPerformPostAssociate 时异步完成关联后操作。 关联后操作完成后，DLL 必须调用 Dot11ExtPostAssociateCompletion。

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

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

要求

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

另请参阅

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION