funktionen WifiConfig_ForgetNetwork

Sidhuvud: #include <applibs/wificonfig.h>

Viktigt

Den här funktionen är föråldrad. Använd WifiConfig_ForgetNetworkById i stället.

Tar bort ett Wi-Fi nätverk från enheten. Kopplar bort enheten från nätverket om den är ansluten. Den här funktionen är inte trådsäker.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parametrar

• storedNetwork Pekare till en WifiConfig_StoredNetwork struct som beskriver det lagrade Wi-Fi nätverk att ta bort.

Fel

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

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

• EFAULT: parametern ssid är NULL.

• ENOENT: parametern storedNetwork matchar inte något av de lagrade nätverken.

• EINVAL: parametern storedNetwork eller dess struct-version är ogiltig.

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

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

• ENOSPC: det finns för många Wi-Fi nätverk för att konfigurationen ska bevaras. ta bort en och försök igen.

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.