WFDOpenHandle-Funktion (wlanapi.h)

Artikel
08/28/2023

Die WFDOpenHandle-Funktion öffnet ein Handle für den Wi-Fi Direct-Dienst und verhandelt eine Version der zu verwendenden Wi-FI Direct-API.

Syntax

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

Parameter

[in] dwClientVersion

Die höchste Version der Wi-Fi Direct-API, die der Client unterstützt.

Für Windows 8 und Windows Server 2012 sollte dieser Parameter auf WFD_API_VERSION festgelegt werden, die in der Headerdatei "Wlanapi.h" definiert ist.

[out] pdwNegotiatedVersion

Ein Zeiger auf ein DWORD , um die ausgehandelte Version zu erhalten.

Wenn die WFDOpenHandle-Funktion erfolgreich ist, wird die mit dem Wi-Fi Direct Service ausgehandelte Version zurückgegeben, die von dieser Sitzung verwendet werden soll. Dieser Wert ist in der Regel die höchste Version, die sowohl vom Client als auch Wi-Fi Direct-Dienst unterstützt wird.

[out] phClientHandle

Ein Zeiger auf einen HANDLE , um das Handle auf den Wi-Fi Direct-Dienst für diese Sitzung zu empfangen.

Wenn die WFDOpenHandle-Funktion erfolgreich ist, wird ein Handle für den Wi-Fi Direct-Dienst zurückgegeben, der in dieser Sitzung verwendet werden soll.

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_PARAMETER	„Der Parameter ist falsch.“ Dieser Fehler wird zurückgegeben, wenn der parameter pdwNegotiatedVersionNULL oder der phClientHandle-ParameterNULL ist. Dieser Wert wird auch zurückgegeben, wenn der dwClientVersion-Parameter nicht gleich WFD_API_VERSION ist.
ERROR_NOT_ENOUGH_MEMORY	Für die Verarbeitung dieses Befehls steht nicht genügend Speicherplatz zur Verfügung. Dieser Fehler wird zurückgegeben, wenn das System nicht in der Lage war, Arbeitsspeicher zuzuweisen, um den Clientkontext zu erstellen.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	Es wurde versucht, eine Sitzung mit einem Netzwerkserver einzurichten, aber es wurden bereits zu viele Sitzungen für diesen Server eingerichtet. Dieser Fehler wird zurückgegeben, wenn vom Wi-Fi Direct-Dienst zu viele Handles ausgegeben wurden.
RPC_STATUS	Verschiedene Fehlercodes.

Hinweise

Die WFDOpenHandle-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 durch die 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 Geräte-zu-Gerät-Konnektivität bereitzustellen, ohne dass ein Drahtloser Zugriffspunkt (Wireless Access Point, Drahtloser AP) zum Einrichten der Verbindung oder die Verwendung des vorhandenen Wi-Fi Adhoc-Mechanismus (IBSS) erforderlich ist.

Um Wi-Fi Direct verwenden zu können, muss eine Anwendung zuerst ein Handle für den Wi-Fi Direct-Dienst abrufen, indem sie die WFDOpenHandle-Funktion aufruft. Das von der WFDOpenHandle-Funktion zurückgegebene Wi-Fi Direct-Handle wird für nachfolgende Aufrufe des Wi-Fi Direct-Diensts verwendet. Sobald eine Anwendung den Wi-Fi Direct-Dienst verwendet, sollte die Anwendung die WFDCloseHandle-Funktion aufrufen, um dem Wi-Fi Direct-Dienst zu signalisieren, dass die Anwendung den Dienst verwendet. Dadurch kann der Wi-Fi Direct-Dienst die von der Anwendung verwendeten Ressourcen freigeben.

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