Sdílet prostřednictvím


funkce WifiConfig_AddNetwork

Hlavička: #include <applibs/wificonfig.h>

Přidá do zařízení Wi-Fi síť a vrátí ID sítě.

int WifiConfig_AddNetwork(void);

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

  • EAGAIN: zařízení Wi-Fi není připravené.

  • ENETDOWN: Wi-Fi síťové rozhraní není k dispozici.

  • ENOMEM: Není k dispozici dostatek paměti pro přidání nové sítě.

Je také možné zadat všechny ostatní errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí ID nové sítě nebo -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu. ID sítě je nula nebo kladná hodnota.

Poznámky

ID sítě se předá funkcím WifiConfig_Set* , jako je například WifiConfig_SetSSID.

Nová síť není nakonfigurovaná a dá se nakonfigurovat pomocí funkcí WifiConfig_Set* . Změny konfigurace sítě jsou účinné okamžitě, ale při restartování zařízení se ztratí, pokud není volána funkce WifiConfig_PersistConfig pro uložení konfigurace do nevolatilní úložiště.

Počet sítí, které můžete na zařízení uložit, není pevný, ale závisí na dostupných prostředcích a velikosti úložiště vyžadované pro každou konfiguraci sítě.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci WifiConfig.