WFDCloseHandle 函数 (wlanapi.h)
WFDCloseHandle 函数关闭 Wi-Fi Direct 服务的句柄。
语法
DWORD WFDCloseHandle(
[in] HANDLE hClientHandle
);
参数
[in] hClientHandle
Wi-Fi Direct 服务的客户端句柄。 此句柄是通过先前对 WFDOpenHandle 函数的调用获取的。
返回值
如果函数成功,则返回值为 ERROR_SUCCESS。
如果函数失败,则返回值可能是以下返回代码之一。
返回代码 | 说明 |
---|---|
|
该句柄无效。
如果在句柄表中找不到 hClientHandle 参数中指定的句柄,则返回此错误。 |
|
参数不正确。
如果 hClientHandle 参数为 NULL 或无效,则返回此错误。 |
|
各种错误代码。 |
注解
WFDCloseHandle 函数是 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,应用程序必须先通过调用 WFDOpenHandle 函数获取 Wi-Fi Direct 服务的句柄。 WFDOpenHandle 函数返回的 Wi-Fi Direct (WFD) 句柄用于对 Wi-Fi Direct 服务进行的后续调用。 使用 Wi-Fi Direct 服务完成应用程序后,应用程序应调用 WFDCloseHandle 函数,以向 Wi-Fi Direct 服务发出信号,表明应用程序是使用该服务完成的。 这样,Wi-Fi Direct 服务就可以释放应用程序使用的资源。
要求
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | wlanapi.h |
Library | Wlanapi.lib |
DLL | Wlanapi.dll |