WFDCloseHandle-Funktion (wlanapi.h)

Artikel
08/28/2023

Die WFDCloseHandle-Funktion schließt ein Handle mit dem Wi-Fi Direct-Dienst.

Syntax

DWORD WFDCloseHandle(
  [in] HANDLE hClientHandle
);

Parameter

[in] hClientHandle

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

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 nicht in der Handle-Tabelle gefunden wurde.
ERROR_INVALID_PARAMETER	„Der Parameter ist falsch.“ Dieser Fehler wird zurückgegeben, wenn der hClientHandle-ParameterNULL oder ungültig ist.
RPC_STATUS	Verschiedene Fehlercodes.

Hinweise

Die WFDCloseHandle-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


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