DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA回调函数 (wlanihv.h)

  • 项目
重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。
 
IHV 扩展 DLL 调用 Dot11ExtSetProfileCustomUserData 函数，以在系统注册表中保存特定于当前用户的数据，以及用于基本服务集 (BSS) 网络连接的网络配置文件的数据。

语法

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)

另请参阅

Dot11ExtIhvInitAdapter

Dot11ExtSetCurrentProfile

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData