DOT11EXTIHV_PERFORM_CAPABILITY_MATCH回调函数（wlanihv.h）

2025-02-07

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

作系统调用 Dot11ExtIhvPerformCapabilityMatch 函数来请求 IHV 扩展 DLL 确定是否检测到的基本服务集（BSS）网络与 IHV 定义的连接和安全配置文件扩展匹配。

语法

DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Dot11extihvPerformCapabilityMatch;

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

参数

[in, optional] hIhvExtAdapter

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

[in, optional] pIhvProfileParams

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

[in] pIhvConnProfile

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

[in] pIhvSecProfile

指向 DOT11EXT_IHV_SECURITY_PROFILE 包含 IHV 配置文件的安全设置的结构。

[in, optional] pConnectableBssid

指向 DOT11_BSS_LIST 结构的指针，该结构包含从 BSS 网络接收的一个或多个 802.11 信标或探测响应帧。此列表派生自 WLAN 适配器执行的最后一次扫描作的结果。有关扫描作的详细信息，请参阅 Native 802.11 扫描作。

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

[out] pdwReasonCode

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

返回值

如果 802.11 信标和探测响应帧列表中的所有条目都支持配置文件片段中定义的连接和安全属性，该函数将返回ERROR_SUCCESS。否则，它将返回 Winerror.h 中定义的错误代码。

言论

WLAN 适配器完成扫描作以检测范围内的 BSS 网络后，作系统可能会调用 Dot11ExtIhvPerformCapabilityMatch 函数来确定检测到的任何 BSS 网络是否与 IHV 定义的连接或安全配置文件扩展匹配。

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

如果 IHV 扩展 DLL 找到与配置文件片段匹配的至少一个 IEEE 802.11 信标或探测响应帧，则必须将 * pdwReasonCode 设置为以下项之一：
- L2_REASON_CODE_SUCCESS。
- L2_REASON_CODE_IHV_BASE到（L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1）范围内的 IHV 定义值。
在这种情况下，Dot11ExtIhvPerformCapabilityMatch 函数必须返回ERROR_SUCCESS。
如果 IHV 扩展 DLL 找不到与配置文件片段匹配的 IEEE 802.11 信标或探测响应帧，则它不得将 *pdwReasonCode 设置为L2_REASON_CODE_SUCCESS。相反，DLL 必须将 * pdwReasonCode 设置为下列项之一：
- 适当的L2_REASON_CODE_xxxx错误值。
- L2_REASON_CODE_IHV_BASE到（L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1）范围内的 IHV 定义值。
在这种情况下，Dot11ExtIhvPerformCapabilityMatch 函数不得返回ERROR_SUCCESS。

有关 Native 802.11 XML 架构的详细信息，请参阅 Microsoft Windows SDK 文档。

要求

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