WifiConfig_ForgetNetwork functie

Header: #include <applibs/wificonfig.h>

Belangrijk

Deze functie is verouderd. Gebruik in plaats hiervan WifiConfig_ForgetNetworkById .

Hiermee verwijdert u een Wi-Fi netwerk van het apparaat. Hiermee wordt het apparaat losgekoppeld van het netwerk als het momenteel is verbonden. Deze functie is niet thread-veilig.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parameters

• storedNetwork Aanwijzer naar een WifiConfig_StoredNetwork-struct waarin het opgeslagen Wi-Fi netwerk wordt beschreven dat moet worden verwijderd.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

• EACCES: het toepassingsmanifest bevat niet de mogelijkheid WifiConfig.

• EFAULT: de ssid parameter is NULL.

• ENOENT: de storedNetwork parameter komt niet overeen met een van de opgeslagen netwerken.

• EINVAL: de storedNetwork parameter of de bijbehorende struct-versie is ongeldig.

• EAGAIN: het Wi-Fi-apparaat is nog niet gereed.

• ENETDOWN: de Wi-Fi netwerkinterface is niet beschikbaar.

• ENOSPC: er zijn te veel Wi-Fi netwerken om de configuratie te behouden; verwijder er een en probeer het opnieuw.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet bewaard via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.