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


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, mint WIFICONFIG_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.