WFDCancelOpenSession 函数 (wlanapi.h)
WFDCancelOpenSession 函数指示应用程序想要取消尚未完成的挂起的 WFDStartOpenSession 函数。
语法
DWORD WFDCancelOpenSession(
[in] HANDLE hSessionHandle
);
参数
[in] hSessionHandle
要取消 Wi-Fi 直接会话的会话句柄。 这是 WFDStartOpenSession 函数先前返回的会话句柄。
返回值
如果函数成功，则返回值为 ERROR_SUCCESS。
如果函数失败，则返回值可能是以下返回代码之一。
| 返回代码 | 说明 |
|---|---|
|
该句柄无效。
如果在句柄表中找不到 hSessionHandle 参数中指定的句柄，则返回此错误。 |
|
参数不正确。
如果 hSessionHandle 参数为 NULL 或无效，则返回此错误。 |
|
各种错误代码。 |
注解
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 |