WFDCancelOpenSession-Funktion (wlanapi.h)
Die WFDCancelOpenSession-Funktion gibt an, dass die Anwendung eine ausstehende WFDStartOpenSession-Funktion abbrechen möchte, die noch nicht abgeschlossen wurde.
Syntax
DWORD WFDCancelOpenSession(
[in] HANDLE hSessionHandle
);
Parameter
[in] hSessionHandle
Ein Sitzungshandle für eine Wi-Fi Direct-Sitzung, die abgebrochen werden soll. 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. |
|
Verschiedene Fehlercodes. |
Hinweise
Die WFDCancelOpenSession-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.
Durch einen Aufruf der WFDCancelOpenSession-Funktion wird der Wi-Fi Direct-Dienst benachrichtigt, dass der Client einen Abbruch dieser Sitzung anfordert. Die WFDCancelOpenSession-Funktion ändert das erwartete WFDStartOpenSession-Verhalten nicht. Die für die WFDStartOpenSession-Funktion angegebene Rückruffunktion wird weiterhin aufgerufen, und die WFDStartOpenSession-Funktion wird möglicherweise nicht sofort abgeschlossen.
Es liegt in der Verantwortung des Aufrufers, der WFDCancelOpenSession-Funktion ein Handle im hSessionHandle-Parameter zu übergeben, das vom Aufruf der WFDStartOpenSession-Funktion zurückgegeben wurde.
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 |