WifiConfig_SetSSID függvény
Fejléc: #include <applibs/wificonfig.h>
Beállítja egy Wi-Fi hálózat SSID-azonosítóját.
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.
static int WifiConfig_SetSSID(int networkId, const uint8_t *ssid, size_t ssidLength);
Paraméterek
networkId
A konfigurálni kívánt hálózat azonosítója. WifiConfig_AddNetwork a hálózati azonosítót adja vissza.ssid
Az új SSID-t tartalmazó bájttömbre mutató mutató. Nincs megadva a karakterkódolás.ssidLength
A paraméterben találhatóssid
bájtok száma. A értéknek kisebbnek vagy egyenlőnek kell lennie.WIFICONFIG_SSID_MAX_LENGTH
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
ssid
paraméter NULL.ERANGE: a
ssidLength
paraméter nagyobb, mintWIFICONFIG_SSID_MAX_LENGTH
.EAGAIN: a Wi-Fi eszköz nem áll készen.
ENETDOWN: a Wi-Fi hálózati adapter nem érhető el.
EINVAL: a
networkId
paraméter érvénytelen.ENODEV: a
networkId
paraméter nem felel meg a tárolt hálózatok egyik azonosítójának sem.
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.