WFDCloseSession-Funktion (wlanapi.h)
Die WFDCloseSession-Funktion schließt eine Sitzung nach einem zuvor erfolgreichen Aufruf der WFDStartOpenSession-Funktion .
Syntax
DWORD WFDCloseSession(
[in] HANDLE hSessionHandle
);
Parameter
[in] hSessionHandle
Ein Sitzungshandle für eine Wi-Fi Direct-Sitzung. Dies ist ein Sitzungshandle, das zuvor von der WFDStartOpenSession-Funktion zurückgegeben wurde.
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 |
|---|---|
|
Das Handle ist ungültig.
Dieser Fehler wird zurückgegeben, wenn das im hSessionHandle-Parameter angegebene Handle in der Handletabelle nicht gefunden wurde. |
|
„Der Parameter ist falsch.“
Dieser Fehler wird zurückgegeben, wenn der hSessionHandle-ParameterNULL oder ungültig ist. |
|
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. |
|
Verschiedene Fehlercodes. |
Hinweise
Die WFDCloseSession-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 WFDCloseSession-Funktion stellt ein zukünftiges Arbeitselement in die Warteschlange, um die Sitzung zu schließen, sodass die Trennung möglicherweise nicht sofort erfolgt.
Wenn Sie die WFDCloseSession-Funktion aufrufen, während ein WFDStartOpenSession-Aufruf aussteht, wird die Sitzung nicht geschlossen.
Es liegt in der Verantwortung des Aufrufers, der WFDCloseSession-Funktion ein Handle im hSessionHandle-Parameter zu übergeben, das von einem erfolgreichen asynchronen Aufruf der WFDStartOpenSession-Funktion zurückgegeben wurde.
Das Aufrufen der WFDCloseSession-Funktion mit einem gültigen und ungültigen Handle führt zu nicht definierten Ergebnissen.
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 |