Megosztás a következőn keresztül:


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.