重要 Windows 10 及更高版本中弃用了 Native 802.11 无线 LAN 接口。 请改用 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 适配器执行的最后一次扫描作的结果。 有关扫描作的详细信息，请参阅 Native 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） |