共用方式為


WFDCloseSession 函式 (wlanapi.h)

WFDCloseSession 函式會在先前成功呼叫 WFDStartOpenSession 函式之後關閉會話。

語法

DWORD WFDCloseSession(
  [in] HANDLE hSessionHandle
);

參數

[in] hSessionHandle

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

傳回值

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

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

傳回碼 Description
ERROR_INVALID_HANDLE
控制代碼無效。

如果在句柄數據表中找不到 hSessionHandle 參數中指定的句柄,就會傳回此錯誤。

ERROR_INVALID_PARAMETER
參數錯誤。

如果 hSessionHandle 參數為 NULL 或無效,就會傳回此錯誤。

ERROR_INVALID_STATE
群組或資源未處於執行要求作業的正確狀態。

如果網域上的組策略停用 Wi-Fi Direct 服務,就會傳回此錯誤。

RPC_STATUS
各種錯誤碼。

備註

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

WFDCloseSession 函式會將未來的工作專案排入佇列以關閉工作階段,因此中斷連線可能不是立即的。

WFDStartOpenSession 呼叫擱置時,呼叫 WFDCloseSession 函式將不會關閉會話。

呼叫端必須負責將 WFDCloseSession 函式傳遞 hSessionHandle 參數中從成功異步呼叫傳回給 WFDStartOpenSession 函式的句柄。

使用有效句柄呼叫 WFDCloseSession 函式,且已變成無效的句柄,將會產生未定義的結果。

規格需求

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

另請參閱

WFDCancelOpenSession

WFDCloseHandle

WFDOpenHandle

WFDOpenLegacySession

WFDStartOpenSession

WFDUpdateDeviceVisibility

WFD_OPEN_SESSION_COMPLETE_CALLBACK