共用方式為

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)
程式庫 Wlanapi.lib
Dll Wlanapi.dll
可轉散發套件 適用于 Windows XP 與 SP2 的無線區域網路 API

另請參閱

WlanOpenHandle