DOT11EXT_SET_CURRENT_PROFILE回调函数 (wlanihv.h)

  • 项目
重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。
 
IHV 扩展 DLL 调用 Dot11ExtSetCurrentProfile 函数，以指定 IHV 定义的连接和安全配置文件片段的设置。 这些片段将应用于当前网络配置文件。

语法

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

参数

[in, optional] hDot11SvcHandle

操作系统用于引用无线 LAN (WLAN) 适配器的句柄。 此句柄值是通过先前对 Dot11ExtIhvInitAdapter IHV 处理程序函数的调用指定的。

[in, optional] hConnectSession

操作系统用于将连接会话与基本服务集 (BSS) 网络引用的句柄。 此句柄值是通过之前对 的调用指定的 Dot11ExtIhvPerformPreAssociate IHV 处理程序函数。

[in, optional] pIhvConnProfile

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

[in, optional] pIhvSecProfile

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

返回值

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

注解

Dot11ExtSetCurrentProfile 函数允许 IHV 将自定义连接和安全配置文件片段添加到用于基本服务集的当前网络配置文件 (BSS) 网络连接。 配置文件片段特定于 IHV，适用于通过 本机 802.11 IHV UI 扩展 DLL 提供给用户的连接或安全扩展。

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

  • 执行通过调用 启动的预关联操作时，IHV 扩展 DLL 只能调用 Dot11ExtSetCurrentProfile Dot11ExtIhvPerformPreAssociate IHV 处理程序函数。 有关预关联操作的详细信息，请参阅 预关联操作。
  • IHV 扩展 DLL 不得从对 的调用中调用 Dot11ExtSetCurrentProfile Dot11ExtIhvPerformPreAssociate IHV 处理程序函数。 必须从处理对 Dot11ExtIhvPerformPreAssociate 调用的线程不同的线程调用 Dot11ExtSetCurrentProfile。

要求

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

另请参阅

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE