语法
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)网络的连接会话的句柄。 此句柄值是通过对
[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) |