Dela via


funktionen WifiConfig_ForgetNetworkById

Sidhuvud: #include <applibs/wificonfig.h>

Tar bort ett Wi-Fi nätverk från enheten. Kopplar bort enheten från nätverket om den är ansluten.

Inställningen börjar gälla omedelbart men finns inte kvar på alla enhetsstarter om inte funktionen WifiConfig_PersistConfig anropas efter den här funktionen.

int WifiConfig_ForgetNetworkById(int networkId);

Parametrar

  • networkId ID för nätverket som ska tas bort.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: programmanifestet innehåller inte WifiConfig-funktionen.

  • EINVAL: parametern networkId är ogiltig.

  • ENOENT: parametern networkId matchar inte något av ID:na för de lagrade nätverken.

  • EAGAIN: Wi-Fi-enheten är inte klar.

  • ENETDOWN: det Wi-Fi nätverksgränssnittet är inte tillgängligt.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar 0 för lyckat resultat, eller -1 för fel, i vilket fall errno är inställt på felvärdet.

Krav för programmanifest

Programmanifestet måste innehålla WifiConfig-funktionen.