WFDStartOpenSession-Funktion (wlanapi.h)

Artikel
03/04/2024

Die WFDStartOpenSession-Funktion startet eine bedarfsgesteuerte Verbindung mit einem bestimmten Wi-Fi Direct-Gerät, das zuvor über die Windows-Kopplung gekoppelt wurde.

Syntax

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

Parameter

[in] hClientHandle

Ein Clienthandle für den Wi-Fi Direct-Dienst. Dieses Handle wurde durch einen vorherigen Aufruf der WFDOpenHandle-Funktion abgerufen.

[in] pDeviceAddress

Ein Zeiger auf die Wi-Fi direkte Geräteadresse des Zielgeräts. Dies ist die MAC-Adresse des Zielgeräts Wi-Fi.

[in, optional] pvContext

Ein optionaler Kontextzeiger, der an die im pfnCallback-Parameter angegebene Rückruffunktion übergeben wird.

[in] pfnCallback

Ein Zeiger auf die Rückruffunktion, die aufgerufen werden soll, sobald die WFDStartOpenSession-Anforderung abgeschlossen ist.

[out] phSessionHandle

Ein Handle für diese spezifische Wi-Fi Direct-Sitzung.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode	Beschreibung
ERROR_INVALID_HANDLE	Das Handle ist ungültig. Dieser Fehler wird zurückgegeben, wenn das im hClientHandle-Parameter angegebene Handle in der Handletabelle nicht gefunden wurde.
ERROR_INVALID_PARAMETER	„Der Parameter ist falsch.“ Dieser Fehler wird zurückgegeben, wenn der hClientHandle-ParameterNULL oder ungültig ist. Dieser Fehler wird auch zurückgegeben, wenn der pDeviceAddress-ParameterNULL, der pfnCallback-ParameterNULL oder der parameter phSessionHandleNULL ist. Dieser Wert wird auch zurückgegeben, wenn der dwClientVersion-Parameter nicht gleich WFD_API_VERSION ist.
ERROR_INVALID_STATE	Die Gruppe oder Ressource befindet sich nicht im richtigen Zustand, um den angeforderten Vorgang durchzuführen. Dieser Fehler wird zurückgegeben, wenn der Wi-Fi Direct-Dienst durch eine Gruppenrichtlinie für eine Domäne deaktiviert wird.
ERROR_SERVICE_NOT_ACTIVE	Der Dienst wurde nicht gestartet. Dieser Fehler wird zurückgegeben, wenn der WLAN AutoConfig-Dienst nicht ausgeführt wird.
RPC_STATUS	Verschiedene Fehlercodes.

Hinweise

Die WFDStartOpenSession-Funktion ist Teil von Wi-Fi Direct, einem neuen Feature in Windows 8 und Windows Server 2012. Wi-Fi Direct basiert auf der Entwicklung der Wi-Fi Peer-to-Peer Technical Specification v1.1 der Wi-Fi Alliance (siehe wi-Fi Alliance Published Specifications). Das Ziel der Wi-Fi Peer-to-Peer Technical Specification besteht darin, eine Lösung für Wi-Fi Device-to-Device-Konnektivität bereitzustellen, ohne dass entweder ein Wireless Access Point (Wireless AP) zum Einrichten der Verbindung oder die Verwendung des vorhandenen Wi-Fi Adhoc-Mechanismus (IBSS) erforderlich ist.

Die WFDStartOpenSession-Funktion startet einen asynchronen Vorgang, um eine bedarfsgesteuerte Verbindung mit einem bestimmten Wi-Fi Direct-Gerät zu starten. Das Ziel Wi-Fi Gerät muss zuvor über die Windows-Kopplung gekoppelt worden sein. Wenn der asynchrone Vorgang abgeschlossen ist, wird die im pfnCallback-Parameter angegebene Rückruffunktion aufgerufen.

Wenn die Anwendung versucht, das Handle für den Wi-Fi Direct-Dienst durch Aufrufen der WFDCloseHandle-Funktion zu schließen, bevor die WFDStartOpenSession-Funktion asynchron abgeschlossen wird, wartet die WFDCloseHandle-Funktion , bis der WFDStartOpenSession-Aufruf abgeschlossen ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wlanapi.h
Bibliothek	Wlanapi.lib
DLL	Wlanapi.dll