Delen via

WifiConfig_StoreWpa2Network functie

  • Artikel

Header: #include <applibs/wificonfig.h>

Belangrijk

Deze functie is verouderd. Gebruik in plaats hiervan WifiConfig_AddNetwork.

Slaat een WPA2-Wi-Fi-netwerk op dat gebruikmaakt van een vooraf gedeelde sleutel. Deze functie is niet thread-veilig.

Opmerking

Deze functie mislukt als er al een netwerk met dezelfde SSID en vooraf gedeelde sleutel is opgeslagen. Zie de foutsectie (EEXIST).

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

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.

  • psk Een aanwijzer naar een buffer die de vooraf gedeelde sleutel voor het Wi-Fi netwerk bevat.

  • pskLength De lengte van de vooraf gedeelde sleutel voor 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: er bestaat al een opgeslagen Wi-Fi netwerk dat dezelfde SSID heeft en WPA2 gebruikt.

  • EFAULT: de ssid of psk is NULL.

  • ERANGE: de ssidLength parameter of pskLength is 0 of groter dan WIFICONFIG_SSID_MAX_LENGTH en WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

  • 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.