WFDCloseSession 函数 (wlanapi.h)

项目
08/28/2023

WFDCloseSession 函数在先前成功调用 WFDStartOpenSession 函数后关闭会话。

语法

DWORD WFDCloseSession(
  [in] HANDLE hSessionHandle
);

参数

[in] hSessionHandle

Wi-Fi Direct 会话的会话句柄。这是 WFDStartOpenSession 函数先前返回的会话句柄。

返回值

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

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

返回代码	说明
ERROR_INVALID_HANDLE	该句柄无效。如果在句柄表中找不到 hSessionHandle 参数中指定的句柄，则返回此错误。
ERROR_INVALID_PARAMETER	参数不正确。如果 hSessionHandle 参数为 NULL 或无效，则返回此错误。
ERROR_INVALID_STATE	组或资源的状态不正确，无法执行请求的操作。如果域上的组策略禁用了 Wi-Fi Direct 服务，则返回此错误。
RPC_STATUS	各种错误代码。

注解

WFDCloseSession 函数是 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) 机制。

WFDCloseSession 函数将未来工作项排队以关闭会话，因此断开连接可能不会立即发生。

在 WFDStartOpenSession 调用 挂起时调用 WFDCloseSession 函数不会关闭会话。

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

使用有效且已失效的句柄调用 WFDCloseSession 函数将产生未定义的结果。

要求

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