WFDOpenHandle-Funktion (wlanapi.h)
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 |
|---|---|
|
„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. |
|
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. |
|
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. |
|
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 |