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