Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |