DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA回调函数 (wlanihv.h)

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

语法

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)

另请参阅

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetProfileCustomUserData Dot11ExtIhvPerformPreAssociate

Dot11ExtSetCurrentProfile