DOT11EXTIHV_CREATE_DISCOVERY_PROFILES回调函数 (wlanihv.h)

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息,请参阅 WLAN 通用 Windows 驱动程序模型

操作系统调用 Dot11ExtIhvCreateDiscoveryProfiles 函数以返回临时连接和安全配置文件片段,这些片段可用于连接到网络配置文件不存在 (BSS) 网络的基本服务集。

语法

DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Dot11extihvCreateDiscoveryProfiles;

DWORD Dot11extihvCreateDiscoveryProfiles(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           BOOL bInsecure,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDOT11EXT_IHV_DISCOVERY_PROFILE_LIST pIhvDiscoveryProfileList,
  [out]          PDWORD pdwReasonCode
)
{...}

参数

[in, optional] hIhvExtAdapter

IHV 扩展 DLL 用于引用无线 LAN (WLAN) 适配器的句柄。 此句柄值是通过之前对 Dot11ExtIhvInitAdapter IHV 处理程序函数的调用指定的。

[in] bInsecure

一个布尔值,指定发现配置文件的安全状态。 如果设置为 TRUE,则 IHV 扩展 DLL 只能返回安全配置文件,例如涉及用户身份验证的配置文件。

[in, optional] pIhvProfileParams

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

[in, optional] pConnectableBssid

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

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

[out] pIhvDiscoveryProfileList

指向 DOT11EXT_IHV_DISCOVERY_PROFILE_LIST 结构,用于指定 IHV 发现配置文件的列表。

[out] pdwReasonCode

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

返回值

如果调用成功,函数将返回ERROR_SUCCESS。 否则,它将返回 Winerror.h 中定义的错误代码。

注解

WLAN 适配器完成扫描操作后,操作系统可能会调用 Dot11ExtIhvCreateDiscoveryProfiles 来创建可用于连接到用户尚未为其创建网络配置文件的 BSS 网络的临时配置文件片段。

调用 Dot11ExtIhvCreateDiscoveryProfiles 时,IHV 扩展 DLL 必须遵循以下准则。

  • 如果 IHV 扩展 DLL 可以返回可用于连接到 BSS 网络的配置文件片段, 则 Dot11ExtIhvCreateDiscoveryProfiles 函数必须返回ERROR_SUCCESS。 否则,函数必须从 Winerror.h 中定义的ERROR_xxxx值返回相应的错误代码。
  • IHV 扩展 DLL 提供有关 Dot11ExtIhvCreateDiscoveryProfiles 函数的返回结果的详细信息。 DLL 必须将 * pdwReasonCode 设置为以下选项之一:
    • L2_REASON_CODE_SUCCESS,是否可以为 BSS 网络列表返回配置文件片段。
    • 如果无法为 BSS 网络列表返回配置文件片段,则为适当的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、Winclient.h、L2cmn.h)

另请参阅

DOT11EXT_IHV_DISCOVERY_PROFILE_LIST

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtAllocateBuffer

DOT11EXT_IHV_PROFILE_PARAMS