Dela via

funktionen WifiConfig_StoreOpenNetwork

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Viktigt

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

Lagrar ett öppet Wi-Fi nätverk utan en nyckel. Den här funktionen är inte trådsäker.

Den här funktionen misslyckas om ett identiskt nätverk redan är lagrat på enheten utan en nyckel. Se felavsnittet (EEXIST). Men om ett lagrat nätverk innehåller en nyckel tillsammans med samma SSID kommer den här funktionen att lyckas och lagra nätverket.

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

Parametrar

  • ssid En pekare till en SSID-bytematris med ospecificerad teckenkodning som identifierar det Wi-Fi nätverket.

  • ssidLength Antalet byte i SSID för det Wi-Fi nätverket.

Fel

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

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

  • EEXIST: ett lagrat Wi-Fi nätverk som har samma SSID och ingen nyckel finns redan.

  • EFAULT: är ssid NULL.

  • ERANGE: är ssidLength 0 eller större än WIFICONFIG_SSID_MAX_LENGTH.

  • 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.