DOT11EXTIHV_PERFORM_PRE_ASSOCIATE回调函数（wlanihv.h）

项目
02/07/2025

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

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

语法

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

DWORD Dot11extihvPerformPreAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in]           PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

参数

[in, optional] hIhvExtAdapter

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

[in, optional] hConnectSession

作系统用来引用与基本服务集（BSS）网络的连接会话的句柄。

[in, optional] pIhvProfileParams

指向 DOT11EXT_IHV_PROFILE_PARAMS 结构。此结构定义将应用配置文件扩展的基本服务集（BSS）网络的属性。

[in] pIhvConnProfile

指向 DOT11EXT_IHV_CONNECTIVITY_PROFILE 结构，其中包含 IHV 配置文件的连接设置。

[in] pIhvSecProfile

指向 DOT11EXT_IHV_SECURITY_PROFILE 结构，该结构指定 IHV 配置文件的安全设置。

[in] pConnectableBssid

指向 DOT11_BSS_LIST 结构的指针，该结构包含 BSS 网络的服务集标识符（SSID）的一个或多个 802.11 信标或探测响应帧，DLL 将对其执行预关联作。

[out] pdwReasonCode

指向 DWORD 值的指针，它为 Dot11ExtIhvPerformPreAssociate 函数的返回值提供附加信息。 IHV 扩展 DLL 必须将 * pdwReasonCode 设置为在 L2cmn.h 中定义的L2_REASON_CODE_xxxx值。

返回值

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

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

言论

作系统调用 Dot11ExtIhvPerformPreAssociate 函数来启动与 IHV 扩展 DLL 的预关联作。作系统在通过 WLAN 适配器启动基本服务集（BSS）网络的连接作之前启动此作。有关连接作的详细信息，请参阅连接作。

预关联作必须从 调用 dot11ExtIhvPerformPreAssociate异步完成。关联前作完成后，IHV 扩展 DLL 必须调用 Dot11ExtPreAssociateCompletion。

调用 Dot11ExtIhvPerformPreAssociate 函数时，IHV 扩展 DLL 必须遵循以下准则。

如果 IHV 扩展 DLL 可以启动预关联作，Dot11ExtIhvPerformPreAssociate 函数必须返回ERROR_SUCCESS并异步完成该作。
IHV 扩展 DLL 提供有关通过 pdwReasonCode 参数启动预关联作的详细信息。 DLL 必须将 * pdwReasonCode 设置为下列项之一：
- L2_REASON_CODE_SUCCESS，如果预关联作可以成功启动。
- 如果无法启动预关联作，则为适当的L2_REASON_CODE_xxxx错误值。
- 从L2_REASON_CODE_IHV_BASE到（L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1）范围内的 IHV 定义值，无论是否可以启动关联前作。

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

要求

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