wlancloseHandle 函数 (wlanapi.h)

  • 项目

WlanCloseHandle 函数关闭与服务器的连接。

语法

DWORD WlanCloseHandle(
  [in] HANDLE hClientHandle,
       PVOID  pReserved
);

参数

[in] hClientHandle

客户端的会话句柄，用于标识要关闭的连接。 此句柄是通过之前对 WlanOpenHandle 函数的调用获取的。

pReserved

保留供将来使用。 将此参数设置为 NULL。

返回值

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

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

返回代码 说明
ERROR_INVALID_PARAMETER
 hClientHandle 为 NULL 或无效，或 pReserved 不为 NULL。
ERROR_INVALID_HANDLE
 在句柄表中找不到句柄 hClientHandle 。
RPC_STATUS
 各种错误代码。

注解

关闭连接后，任何尝试使用已关闭句柄都可能导致意外错误。 关闭后，将丢弃所有未完成的通知。

不要从回调函数调用 WlanCloseHandle 。 如果在调用 WlanCloseHandle 时客户端处于通知回调的中间，则函数会等待回调完成，然后再返回值。 在回调函数中调用此函数将导致调用永不完成。 如果回调函数和关闭句柄的线程都尝试获取相同的锁，则可能会出现死锁。 此外，不要从应用程序 DLL 中的 DllMain 函数调用 WlanCloseHandle。 这也可能导致死锁。

要求

   
最低受支持的客户端 Windows Vista、Windows XP SP3 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wlanapi.h (包括 Wlanapi.h)
Library Wlanapi.lib
DLL Wlanapi.dll
可再发行组件 带有 SP2 的 Windows XP 无线 LAN API

另请参阅

WlanOpenHandle