WFDOpenLegacySession 函数 (wlanapi.h)

项目
08/28/2023

WFDOpenLegacySession 函数检索并应用 Wi-Fi Direct 旧版设备的存储配置文件。

语法

DWORD WFDOpenLegacySession(
  HANDLE             hClientHandle,
  PDOT11_MAC_ADDRESS pLegacyMacAddress,
  HANDLE             *phSessionHandle,
  GUID               *pGuidSessionInterface
);

参数

hClientHandle

此会话的 Wi-Fi Direct 服务的句柄。使用 WFDOpenHandle 函数检索此参数。

pLegacyMacAddress

指向旧版客户端设备的 Wi-Fi 直接设备地址的指针。

phSessionHandle

指向 HANDLE 的指针，用于接收此会话的 Wi-Fi Direct 服务的句柄。

如果 WFDOpenLegacySession 函数成功，则返回此会话中使用的 Wi-Fi Direct 服务的句柄。

pGuidSessionInterface

指向此会话网络接口 GUID 的指针。

如果 WFDOpenLegacySession 函数成功，则返回网络接口的 GUID，Wi-Fi Direct 会话。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值可能是以下返回代码之一。

返回代码	说明
ERROR_INVALID_PARAMETER	参数不正确。如果 phClientHandle 或 pLegacyMacAddress 参数为 NULL，则返回此错误。
ERROR_NOT_ENOUGH_MEMORY	没有足够的存储空间可用于处理此命令。如果系统无法分配内存来创建客户端上下文，则返回此错误。
RPC_STATUS	各种错误代码。

注解

WFDOpenLegacySession 函数是 Wi-Fi Direct 的一部分，这是 Windows 8 和 Windows Server 2012 中的一项新功能。 Wi-Fi Direct 基于 Wi-Fi 联盟 Wi-Fi 对等技术规范 v1.1 的开发， (请参阅 Wi-Fi 联盟发布的规范) 。 Wi-Fi 对等技术规范的目标是为 Wi-Fi 设备到设备连接提供解决方案，而无需无线接入点 (无线 AP) 来设置连接或使用现有的 Wi-Fi adhoc (IBSS) 机制。

若要使用 Wi-Fi Direct，应用程序必须先通过调用 WFDOpenLegacySession 或 WFDOpenHandle 函数来获取 Wi-Fi Direct 服务的句柄。 WFDOpenHandle 函数返回的 Wi-Fi Direct (WFD) 句柄用于对 Wi-Fi Direct 服务进行的后续调用。 WFDOpenLegacySession 函数用于检索和应用 Wi-Fi Direct 旧版设备的存储配置文件。

WFDOpenLegacySession 函数从指定旧设备地址的配置文件存储中检索设备的存储旧配置文件。必须从由于收件箱配对体验 (旧版 WPS 配对) 而创建的设备节点获取此设备地址。

使用 Wi-Fi Direct 服务完成应用程序后，应用程序应调用 WFDCloseSession 函数以关闭会话，并调用 WFDCloseHandle 函数以向 Wi-Fi Direct 服务发出信号，表明应用程序是使用该服务完成的。这样，Wi-Fi Direct 服务就可以释放应用程序使用的资源。

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
目标平台	Windows
标头	wlanapi.h
Library	Wlanapi.lib
DLL	Wlanapi.dll