Dela via

funktionen WifiConfig_AddNetwork

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Lägger till ett Wi-Fi nätverk på enheten och returnerar nätverkets ID.

int WifiConfig_AddNetwork(void);

Fel

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

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

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

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

  • ENOMEM: Det finns inte tillräckligt med minne för att lägga till ett nytt nätverk.

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

Returvärde

Returnerar ID för det nya nätverket, eller -1 för fel, i vilket fall errno är inställt på felvärdet. Nätverks-ID är noll eller ett positivt värde.

Anmärkningar

Nätverks-ID:t skickas till WifiConfig_Set* funktioner, till exempel WifiConfig_SetSSID.

Det nya nätverket är inte konfigurerat och kan konfigureras med funktionerna WifiConfig_Set* . Ändringar av nätverkskonfigurationen börjar gälla omedelbart men går förlorade när enheten startas om om inte funktionen WifiConfig_PersistConfig anropas för att spara konfigurationen till icke-volatil lagring.

Antalet nätverk som du kan lagra på en enhet är inte fast, men beror på tillgängliga resurser och hur mycket lagringsutrymme som krävs för varje nätverkskonfiguration.

Krav för programmanifest

Programmanifestet måste innehålla WifiConfig-funktionen.