通过

DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA回调函数 （wlanihv.h）

  • 项目
重要 Windows 10 及更高版本中弃用了 Native 802.11 无线 LAN 接口。 请改用 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 参数引用的数据。 IHV 扩展 DLL 应在调用 Dot11ExtGetProfileCustomUserData后使用自己的解密算法来解密数据。

对于 Native Wifi AutoConfig 服务使用的每个无线 WLAN 配置文件，Windows 维护自定义用户数据的概念。 此自定义用户数据最初不存在，但可以通过调用 Dot11ExtSetProfileCustomUserData 函数。 每当通过调用 来修改配置文件时，自定义用户数据将重置为空 Dot11ExtSetCurrentProfile 函数。

设置自定义用户数据后，可以使用 Dot11ExtGetProfileCustomUserData 函数访问此数据。

调用方负责使用 Dot11ExtFreeBuffer 函数释放由 ppvData 参数指向的缓冲区分配的内存。

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的 Windows作系统中可用。
目标平台 桌面
标头 wlanihv.h （包括 Wlanihv.h）

另请参阅

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetProfileCustomUserData Dot11ExtIhvPerformPreAssociate

Dot11ExtSetCurrentProfile