WifiConfig_ForgetNetwork-Funktion

Header: #include <applibs/wificonfig.h>

Wichtig

Diese Funktion ist veraltet. Verwenden Sie stattdessen WifiConfig_ForgetNetworkById .

Entfernt ein Wi-Fi Netzwerk vom Gerät. Trennt das Gerät vom Netzwerk, wenn es derzeit verbunden ist. Diese Funktion ist nicht threadsicher.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parameter

• storedNetwork Zeiger auf eine WifiConfig_StoredNetwork Struktur, die die gespeicherte Wi-Fi zu entfernenden Netzwerk beschreibt.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

• EACCES: Das Anwendungsmanifest enthält die WifiConfig-Funktion nicht.

• EFAULT: Der ssid Parameter ist NULL.

• ENOENT: Der storedNetwork Parameter stimmt mit keinem der gespeicherten Netzwerke überein.

• EINVAL: Der storedNetwork Parameter oder seine Strukturversion ist ungültig.

• EAGAIN: Das Wi-Fi Gerät ist noch nicht bereit.

• ENETDOWN: Die Wi-Fi Netzwerkschnittstelle ist nicht verfügbar.

• ENOSPC: Es gibt zu viele Wi-Fi Netzwerke, als dass die Konfiguration beibehalten werden kann; Entfernen Sie eine, und versuchen Sie es erneut.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.

Rückgabewert

Gibt 0 für erfolg oder -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die WifiConfig-Funktion enthalten.