WifiConfig_ForgetNetworkById függvény
Fejléc: #include <applibs/wificonfig.h>
Eltávolít egy Wi-Fi hálózatot az eszközről. Leválasztja az eszközt a hálózatról, ha jelenleg csatlakoztatva van.
A beállítás azonnal érvénybe lép, de nem marad meg az eszköz újraindítása során, kivéve, ha a függvény után a WifiConfig_PersistConfig függvényt hívja meg.
int WifiConfig_ForgetNetworkById(int networkId);
Paraméterek
-
networkId
Az eltávolítandó hálózat azonosítója.
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.
EINVAL: a
networkId
paraméter érvénytelen.ENOENT: a
networkId
paraméter nem felel meg a tárolt hálózatok egyik azonosítójának sem.EAGAIN: a Wi-Fi eszköz nem áll készen.
ENETDOWN: a Wi-Fi hálózati adapter nem érhető el.
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
0 értéket ad vissza a sikerhez, vagy -1 hibát, amely esetben errno
a hibaérték van beállítva.
Alkalmazásjegyzékre vonatkozó követelmények
Az alkalmazásjegyzéknek tartalmaznia kell a WifiConfig képességet.