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