WifiConfig_ForgetNetworkById-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

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

Die Einstellung wird sofort wirksam, wird aber nicht über Geräteneustarts hinweg beibehalten, es sei denn, die WifiConfig_PersistConfig Funktion wird nach dieser Funktion aufgerufen.

int WifiConfig_ForgetNetworkById(int networkId);

Parameter

  • networkId Die ID des zu entfernenden Netzwerks.

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.

  • EINVAL: Der networkId Parameter ist ungültig.

  • ENOENT: Der networkId Parameter stimmt mit keiner der IDs der gespeicherten Netzwerke überein.

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

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

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.