Share via

WifiConfig_AddNetwork functie

  • Artikel

Header: #include <applibs/wificonfig.h>

Voegt een Wi-Fi netwerk toe aan het apparaat en retourneert de id van het netwerk.

int WifiConfig_AddNetwork(void);

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

  • EACCES: het toepassingsmanifest bevat niet de mogelijkheid WifiConfig.

  • EAGAIN: het Wi-Fi apparaat is niet gereed.

  • ENETDOWN: de Wi-Fi netwerkinterface is niet beschikbaar.

  • ENOMEM: er is onvoldoende geheugen om een nieuw netwerk toe te voegen.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet bewaard via systeemupdates.

Retourwaarde

Retourneert de id van het nieuwe netwerk, of -1 voor een fout, in welk geval errno is ingesteld op de foutwaarde. De netwerk-id is nul of een positieve waarde.

Opmerkingen

De netwerk-id wordt doorgegeven aan WifiConfig_Set* -functies, zoals WifiConfig_SetSSID.

Het nieuwe netwerk is niet geconfigureerd en kan worden geconfigureerd met de functies WifiConfig_Set* . Wijzigingen in de netwerkconfiguratie zijn onmiddellijk van kracht, maar gaan verloren wanneer het apparaat opnieuw wordt opgestart, tenzij de functie WifiConfig_PersistConfig wordt aangeroepen om de configuratie op te slaan in niet-compatibele opslag.

Het aantal netwerken dat u op een apparaat kunt opslaan, is niet vast, maar is afhankelijk van de beschikbare resources en de hoeveelheid opslagruimte die nodig is voor elke netwerkconfiguratie.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.