Delen via

WifiConfig_StoreOpenNetwork functie

  • Artikel

Header: #include <applibs/wificonfig.h>

Belangrijk

Deze functie is verouderd. Gebruik in plaats hiervan WifiConfig_AddNetwork.

Slaat een open Wi-Fi netwerk op zonder sleutel. Deze functie is niet thread-veilig.

Deze functie mislukt als er al een identiek netwerk is opgeslagen op het apparaat zonder een sleutel. Zie de foutsectie (EEXIST). Als een opgeslagen netwerk echter een sleutel en dezelfde SSID bevat, slaagt deze functie en slaat het netwerk op.

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

Parameters

  • ssid Een aanwijzer naar een SSID-bytematrix met niet-opgegeven tekencodering die het Wi-Fi netwerk identificeert.

  • ssidLength Het aantal bytes in de SSID van het Wi-Fi netwerk.

Fouten

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

  • EACCES: het toepassingsmanifest bevat niet de mogelijkheid WifiConfig.

  • EEXIST: een opgeslagen Wi-Fi netwerk met dezelfde SSID en er bestaat nog geen sleutel.

  • EFAULT: de ssid is NULL.

  • ERANGE: de ssidLength is 0 of groter dan WIFICONFIG_SSID_MAX_LENGTH.

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

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

  • ENOSPC: er zijn te veel Wi-Fi netwerken om de configuratie te behouden; verwijder er een en probeer het opnieuw.

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

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.