共用方式為


WFDOpenHandle 函式 (wlanapi.h)

WFDOpenHandle 函式會開啟 Wi-Fi Direct 服務的句柄,並交涉要使用的Wi-FI Direct API 版本。

語法

DWORD WFDOpenHandle(
  [in]  DWORD   dwClientVersion,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

參數

[in] dwClientVersion

用戶端支援的 Wi-Fi Direct API 最高版本。

對於 Windows 8 和 Windows Server 2012,此參數應該設定為 WFD_API_VERSION這是 Wlanapi.h 頭文件中定義的常數。

[out] pdwNegotiatedVersion

要接收交涉版本的 DWORD 指標。

如果 WFDOpenHandle 函式成功,則會傳回與此工作階段所要使用的 Wi-Fi Direct Service 交涉的版本。 此值通常是用戶端和 Wi-Fi Direct 服務所支援的最高版本。

[out] phClientHandle

句柄的指標,可接收此會話之 Wi-Fi Direct 服務的句柄。

如果 WFDOpenHandle 函式成功,則會傳回此工作階段中要使用的 Wi-Fi Direct 服務句柄。

傳回值

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

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

傳回碼 Description
ERROR_INVALID_PARAMETER
參數錯誤。

如果 pdwNegotiatedVersion 參數為 NULLphClientHandle 參數為 NULL,則會傳回 此錯誤。 如果 dwClientVersion 參數不等於 WFD_API_VERSION,也會傳回此值。

ERROR_NOT_ENOUGH_MEMORY
沒有足夠的記憶體可用來處理此命令。

如果系統無法配置記憶體來建立客戶端內容,就會傳回此錯誤。

ERROR_REMOTE_SESSION_LIMIT_EXCEEDED
嘗試建立網路伺服器的會話,但該伺服器已建立太多會話。

如果 Wi-Fi Direct 服務發出太多句柄,就會傳回此錯誤。

RPC_STATUS
各種錯誤碼。

備註

WFDOpenHandle 函式是 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

另請參閱

WFDCancelOpenSession

WFDCloseHandle

WFDCloseSession

WFDOpenLegacySession

WFDStartOpenSession

WFDUpdateDeviceVisibility

WFD_OPEN_SESSION_COMPLETE_CALLBACK