WFDCloseHandle 函式 (wlanapi.h)
WFDCloseHandle函式會關閉 Wi-Fi Direct 服務的控制碼。
語法
DWORD WFDCloseHandle(
[in] HANDLE hClientHandle
);
參數
[in] hClientHandle
Wi-Fi Direct 服務的用戶端控制碼。 此控制碼是由先前呼叫 WFDOpenHandle 函式所取得。
傳回值
如果函式成功，傳回值會ERROR_SUCCESS。
如果函式失敗，傳回值可能是下列其中一個傳回碼。
| 傳回碼 | Description |
|---|---|
|
控制代碼無效。
如果在控制碼資料表中找不到 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 臨機 (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 直接服務釋放應用程式所使用的資源。
規格需求
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | wlanapi.h |
| 程式庫 | Wlanapi.lib |
| Dll | Wlanapi.dll |