WFDCancelOpenSession-Funktion (wlanapi.h)

Artikel
03/04/2024

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
ERROR_INVALID_HANDLE	Das Handle ist ungültig. Dieser Fehler wird zurückgegeben, wenn das im hSessionHandle-Parameter angegebene Handle in der Handletabelle nicht gefunden wurde.
ERROR_INVALID_PARAMETER	„Der Parameter ist falsch.“ Dieser Fehler wird zurückgegeben, wenn der hSessionHandle-ParameterNULL oder ungültig ist.
RPC_STATUS	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