WFDCancelOpenSession 函数 (wlanapi.h)

项目
12/22/2023

WFDCancelOpenSession 函数指示应用程序想要取消尚未完成的挂起的 WFDStartOpenSession 函数。

语法

DWORD WFDCancelOpenSession(
  [in] HANDLE hSessionHandle
);

参数

[in] hSessionHandle

要取消 Wi-Fi 直接会话的会话句柄。这是 WFDStartOpenSession 函数先前返回的会话句柄。

返回值

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

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

返回代码	说明
ERROR_INVALID_HANDLE	该句柄无效。如果在句柄表中找不到 hSessionHandle 参数中指定的句柄，则返回此错误。
ERROR_INVALID_PARAMETER	参数不正确。如果 hSessionHandle 参数为 NULL 或无效，则返回此错误。
RPC_STATUS	各种错误代码。

注解

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

调用 WFDCancelOpenSession 函数会通知 Wi-Fi Direct 服务客户端请求取消此会话。 WFDCancelOpenSession 函数不会修改预期的 WFDStartOpenSession 行为。仍会调用为 WFDStartOpenSession 函数指定的回调函数，并且 WFDStartOpenSession 函数可能不会立即完成。

调用方负责向 WFDCancelOpenSession 函数传递 hSessionHandle 参数中的句柄，该句柄是从调用 WFDStartOpenSession 函数返回的。

要求

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