WFD_OPEN_SESSION_COMPLETE_CALLBACK wlanapi.h) (回呼函式

發行項
03/04/2024

WFD_OPEN_SESSION_COMPLETE_CALLBACK函式會定義 WFDStartOpenSession 函式在 WFDStartOpenSession 作業完成時所呼叫的回呼函式。

語法

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

參數

[in] hSessionHandle

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

[in] pvContext

從 WFDStartOpenSession 函式傳遞至回調函式的內容指標。

[in] guidSessionInterface

此 Wi-Fi Direct 裝置具有開啟會話之局域網路介面的介面的介面 GUID。如果較高層級的通訊協定需要判斷 Wi-Fi Direct 工作階段所系結的網路介面，此參數會很有用。只有在 dwError 參數ERROR_SUCCESS時，才會傳回此值。

[in] dwError

值，指定在呼叫 WFDStartOpenSession 函式期間是否發生錯誤。如果此值ERROR_SUCCESS，則不會發生任何錯誤，而且開啟會話的作業已順利完成。

以下是可能的其他值：

值	意義
ERROR_INVALID_PARAMETER	參數錯誤。如果 hClientHandle 參數為 NULL 或無效，則會傳回此錯誤。
ERROR_INVALID_STATE	群組或資源未處於執行要求作業的正確狀態。如果網域上的組策略已停用 Wi-Fi Direct 服務，就會傳回此錯誤。
ERROR_SERVICE_NOT_ACTIVE	尚未啟動服務。如果WLAN自動設定服務未執行，則會傳回此錯誤。
RPC_STATUS	各種 RPC 和其他錯誤碼。使用 FormatMessage 取得傳回錯誤的訊息字串。

[in] dwReasonCode

值，指定 WFDStartOpenSession 期間發生錯誤時的更詳細數據。

傳回值

無

備註

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

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

規格需求

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