DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA回调函数 (wlanihv.h)
语法
DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA Dot11extSetProfileCustomUserData;
DWORD Dot11extSetProfileCustomUserData(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] HANDLE hConnectSession,
[in] DWORD dwSessionID,
[in] DWORD dwDataSize,
[in] LPVOID pvData
)
{...}
参数
[in, optional] hDot11SvcHandle
操作系统用于引用无线 LAN (WLAN) 适配器的句柄。 此句柄值是通过之前对 Dot11ExtIhvInitAdapter IHV 处理程序函数的调用指定的。
[in, optional] hConnectSession
操作系统用于引用与 BSS 网络的连接会话的句柄。 此句柄值是通过之前对 的调用指定的 Dot11ExtIhvPerformPreAssociate IHV 处理程序函数。
[in] dwSessionID
会话标识符 (当前用户的会话 ID) 。
[in] dwDataSize
pvData 引用的缓冲区的大小（以字节为单位）。
[in] pvData
指向调用方分配的缓冲区的指针，该缓冲区包含 IHV 定义的格式的数据。
返回值
如果调用成功，函数将返回ERROR_SUCCESS。 否则，它将返回 Winerror.h 中定义的错误代码。
注解
在将 pvData 参数引用的数据存储在系统注册表中之前，操作系统不会对其进行加密。 在调用 Dot11ExtSetProfileCustomUserData 之前，IHV 扩展 DLL 应使用自己的加密算法来加密数据。
对于 Native Wifi AutoConfig 服务使用的每个无线 WLAN 配置文件，Windows 维护自定义用户数据的概念。 此自定义用户数据最初不存在，但可以通过调用 Dot11ExtSetProfileCustomUserData 函数进行设置。 每当通过调用 修改配置文件时，自定义用户数据都会重置为空 Dot11ExtSetCurrentProfile 函数。
设置自定义用户数据后，可以使用 访问此数据 Dot11ExtGetProfileCustomUserData 函数。 操作系统将数据存储在系统注册表HKEY_CURRENT_USER用户键下，该密钥由 dwSessionID 参数中传递的句柄所引用。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
| 目标平台 | 桌面 |
| 标头 | wlanihv.h (包括 Wlanihv.h) |