WFDCancelOpenSession 函式 (wlanapi.h)

發行項
03/13/2024

WFDCancelOpenSession 函式表示應用程式想要取消尚未完成的暫止 WFDStartOpenSession 函式。

語法

DWORD WFDCancelOpenSession(
  [in] HANDLE hSessionHandle
);

參數

[in] hSessionHandle

要取消之 Wi-Fi 直接會話的會話句柄。這是 WFDStartOpenSession 函式先前傳回的會話句柄。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值可能是下列其中一個傳回碼。

傳回碼	Description
ERROR_INVALID_HANDLE	控制代碼無效。如果在句柄數據表中找不到 hSessionHandle 參數中指定的句柄，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	參數錯誤。如果 hSessionHandle 參數為 NULL 或無效，則會傳回此錯誤。
RPC_STATUS	各種錯誤碼。

備註

WFDCancelOpenSession 函式是 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) 機制。

對 WFDCancelOpenSession 函式的呼叫會通知 Wi-Fi Direct 服務，用戶端要求取消此會話。 WFDCancelOpenSession 函式不會修改預期的 WFDStartOpenSession 行為。仍然會呼叫指定給 WFDStartOpenSession 函 式的回呼函式，而且 WFDStartOpenSession 函式可能不會立即完成。

呼叫端必須負責傳遞 WFDCancelOpenSession 函式的句柄，該句柄是在從呼叫 WFDStartOpenSession 函式傳回的 hSessionHandle 參數中傳回的句柄。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	wlanapi.h
程式庫	Wlanapi.lib
Dll	Wlanapi.dll