Share via


WifiConfig_ForgetNetworkById functie

Header: #include <applibs/wificonfig.h>

Hiermee verwijdert u een Wi-Fi netwerk van het apparaat. Hiermee wordt het apparaat losgekoppeld van het netwerk als het momenteel is verbonden.

De instelling is onmiddellijk van kracht, maar blijft niet behouden wanneer het apparaat opnieuw wordt opgestart, tenzij de functie WifiConfig_PersistConfig wordt aangeroepen na deze functie.

int WifiConfig_ForgetNetworkById(int networkId);

Parameters

  • networkId De id van het netwerk 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.

  • EINVAL: de networkId parameter is ongeldig.

  • ENOENT: de networkId parameter komt niet overeen met een van de id's van de opgeslagen netwerken.

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

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

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.