DOT11EXTIHV_PERFORM_PRE_ASSOCIATE回调函数 (wlanihv.h)

项目
02/27/2024

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。请改用 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 结构的指针，该结构包含一个或多个 802.11 信标或探测响应帧，用于服务集标识符 (SSID) 的 BSS 网络，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)