DOT11EXT_SET_CURRENT_PROFILE回调函数 (wlanihv.h)

重要 Windows 10 及更高版本中弃用了 Native 802.11 无线 LAN 接口。 请改用 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,适用于通过 Native 802.11 IHV UI 扩展 DLL提供给用户的连接或安全扩展。

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

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

要求

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

另请参阅

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE