WFDStartOpenSession 函式 (wlanapi.h)

發行項
03/13/2024

WFDStartOpenSession 函式會啟動特定 Wi-Fi Direct 裝置的隨選連線，此裝置先前已透過 Windows 配對體驗配對。

語法

DWORD WFDStartOpenSession(
  [in]           HANDLE                             hClientHandle,
  [in]           PDOT11_MAC_ADDRESS                 pDeviceAddress,
  [in, optional] PVOID                              pvContext,
  [in]           WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
  [out]          PHANDLE                            phSessionHandle
);

參數

[in] hClientHandle

Wi-Fi Direct 服務的用戶端句柄。這個句柄是由先前呼叫 WFDOpenHandle 函式所取得。

[in] pDeviceAddress

目標裝置 Wi-Fi 直接裝置位址的指標。這是目標 Wi-Fi 裝置的 MAC 位址。

[in, optional] pvContext

選擇性的內容指標，傳遞至 pfnCallback 參數中指定的回呼函式。

[in] pfnCallback

一旦 WFDStartOpenSession 要求完成之後，要呼叫的回呼函式指標。

[out] phSessionHandle

這個特定 Wi-Fi 直接會話的句柄。

傳回值

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

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

傳回碼	Description
ERROR_INVALID_HANDLE	控制代碼無效。如果在句柄數據表中找不到 hClientHandle 參數中指定的句柄，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	參數錯誤。如果 hClientHandle 參數為 NULL 或無效，就會傳回此錯誤。如果 pDeviceAddress 參數為 NULL、 pfnCallback 參數為 NULL，或 phSessionHandle 參數為 NULL，也會傳回此錯誤。如果 dwClientVersion 參數不等於 WFD_API_VERSION，也會傳回此值。
ERROR_INVALID_STATE	群組或資源未處於執行要求作業的正確狀態。如果網域上的組策略停用 Wi-Fi Direct 服務，就會傳回此錯誤。
ERROR_SERVICE_NOT_ACTIVE	尚未啟動服務。如果WLAN自動設定服務未執行，就會傳回此錯誤。
RPC_STATUS	各種錯誤碼。

備註

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

WFDStartOpenSession 函式會啟動異步操作，以啟動特定 Wi-Fi 直接裝置的隨選連線。目標 Wi-Fi 裝置先前必須透過 Windows 配對體驗配對。異步操作完成時，會呼叫 pfnCallback 參數中指定的回呼函式。

如果應用程式嘗試在 WFDStartOpenSession 函式完成之前呼叫 WFDCloseHandle 函式，關閉對 Wi-Fi Direct 服務的句柄，WFDCloseHandle 函式會等到 WFDStartOpenSession 呼叫完成為止。

規格需求

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