WFDOpenLegacySession 函式 (wlanapi.h)

發行項
03/04/2024

WFDOpenLegacySession 函式會擷取並套用 Wi-Fi Direct 舊版裝置的預存配置檔。

語法

DWORD WFDOpenLegacySession(
  HANDLE             hClientHandle,
  PDOT11_MAC_ADDRESS pLegacyMacAddress,
  HANDLE             *phSessionHandle,
  GUID               *pGuidSessionInterface
);

參數

hClientHandle

此工作階段 Wi-Fi 直接服務的句柄。使用 WFDOpenHandle 函式擷取此參數。

pLegacyMacAddress

Wi-Fi 舊版用戶端裝置直接裝置位址的指標。

phSessionHandle

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

如果 WFDOpenLegacySession 函 式成功，則會傳回此會話中要使用的 Wi-Fi Direct 服務句柄。

pGuidSessionInterface

這個會話網路介面之 GUID 的指標。

如果 WFDOpenLegacySession 函 式成功，則會傳回 Wi-Fi Direct 會話的網路介面 GUID。

傳回值

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

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

傳回碼	Description
ERROR_INVALID_PARAMETER	參數錯誤。如果 phClientHandle 或 pLegacyMacAddress 參數為 NULL，就會傳回此錯誤。
ERROR_NOT_ENOUGH_MEMORY	沒有足夠的記憶體可用來處理此命令。如果系統無法配置記憶體來建立客戶端內容，就會傳回此錯誤。
RPC_STATUS	各種錯誤碼。

備註

WFDOpenLegacySession 函式是 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，應用程式必須先呼叫 WFDOpenLegacySession 或 WFDOpenHandle 函式，以取得 Wi-Fi Direct 服務的句柄。 WFDOpenHandle 函式所傳回的 Wi-Fi Direct (WFD) 句柄會用於後續對 Wi-Fi Direct 服務的呼叫。 WFDOpenLegacySession 函式可用來擷取並套用 Wi-Fi Direct 舊版裝置的預存配置檔。

WFDOpenLegacySession 函式會從指定舊版裝置位址的配置檔存放區擷取裝置的預存舊版配置檔。您必須從建立的裝置節點取得此裝置地址，因為收件匣配對體驗 (舊版 WPS 配對) 。

一旦應用程式使用 Wi-Fi Direct 服務完成之後，應用程式應該呼叫 WFDCloseSession 函式來關閉會話，並呼叫 WFDCloseHandle 函式以向 Wi-Fi Direct 服務發出訊號，指出應用程式是使用服務完成的。這可讓 Wi-Fi 直接服務釋放應用程式所使用的資源。

規格需求

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