WFDCloseSession 函数 (wlanapi.h)
WFDCloseSession 函数在先前成功调用 WFDStartOpenSession 函数后关闭会话。
语法
DWORD WFDCloseSession(
[in] HANDLE hSessionHandle
);
参数
[in] hSessionHandle
Wi-Fi Direct 会话的会话句柄。 这是 WFDStartOpenSession 函数先前返回的会话句柄。
返回值
如果函数成功，则返回值为 ERROR_SUCCESS。
如果函数失败，则返回值可能是以下返回代码之一。
| 返回代码 | 说明 |
|---|---|
|
该句柄无效。
如果在句柄表中找不到 hSessionHandle 参数中指定的句柄，则返回此错误。 |
|
参数不正确。
如果 hSessionHandle 参数为 NULL 或无效，则返回此错误。 |
|
组或资源的状态不正确，无法执行请求的操作。
如果域上的组策略禁用了 Wi-Fi Direct 服务，则返回此错误。 |
|
各种错误代码。 |
注解
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 |