WifiConfig_GetScannedNetworks függvény
Fejléc: #include <applibs/wificonfig.h>
Lekéri a legutóbbi vizsgálati művelet által talált Wi-Fi hálózatokat. Ez a függvény nem szálbiztos.
Ha
scannedNetworkArray
túl kicsi az összes hálózat tárolásához, ez a függvény kitölti az összes elemet, és visszaadja a tömbelemek számát.Ha a WiFiConfig képesség nincs jelen, a függvény egy üres tömböt ad vissza.
ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);
Paraméterek
scannedNetworkArray
Egy tömbre mutató mutató, amely a lekért Wi-Fi hálózatokat adja vissza.scannedNetworkArrayCount
A beolvasott elemek számaNetworkArray tárolható. A tömbnek egy elemet kell rendelkeznie minden Wi-Fi hálózathoz, amelyet a legutóbbi vizsgálati művelet talált.
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.
EFAULT: a
scannedNetworkArray
paraméter NULL.ERANGE: a
scannedNetworkArrayCount
paraméter 0.EINVAL: a
scannedNetworkArray
paraméter vagy annak struktúrájának verziója érvénytelen.EAGAIN: a Wi-Fi eszköz még nem áll készen.
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
A scannedNetworkArray által visszaadott WifiConfig_ScannedNetwork elemek számát adja vissza, 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.