WifiConfig_AddNetwork függvény
Fejléc: #include <applibs/wificonfig.h>
Hozzáad egy Wi-Fi hálózatot az eszközhöz, és visszaadja a hálózat azonosítóját.
int WifiConfig_AddNetwork(void);
Hibák
-1 értéket ad vissza, ha hiba történik, és a hibaértékre van halmazva errno
.
EACCES: az alkalmazásjegyzék nem tartalmazza a WifiConfig képességet.
EAGAIN: a Wi-Fi eszköz nem áll készen.
ENETDOWN: a Wi-Fi hálózati adapter nem érhető el.
ENOMEM: nincs elég memória egy új hálózat hozzáadásához.
errno
Más is megadható; az ilyen hibák nem determinisztikusak, és előfordulhat, hogy a rendszerfrissítések nem őrzik meg ugyanazt a viselkedést.
Visszatérési érték
Az új hálózat azonosítóját adja vissza, hiba esetén -1 értéket, amely esetben errno
a hibaérték van beállítva. A hálózati azonosító nulla vagy pozitív érték.
Megjegyzések
A rendszer WifiConfig_Set* függvények, például WifiConfig_SetSSID számára továbbítja a hálózati azonosítót.
Az új hálózat nincs konfigurálva, és a WifiConfig_Set* függvényekkel konfigurálható. A hálózati konfiguráció módosításai azonnal életbe lépnek, de az eszköz újraindításakor elvesznek, kivéve, ha a WifiConfig_PersistConfig függvény meghívásával a konfigurációt nemvolatilis tárolóba menti.
Az eszközön tárolható hálózatok száma nincs rögzítve, de az elérhető erőforrásoktól és az egyes hálózati konfigurációkhoz szükséges tárterülettől függ.
Alkalmazásjegyzékre vonatkozó követelmények
Az alkalmazásjegyzéknek tartalmaznia kell a WifiConfig képességet.