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