Dela via

funktionen WifiConfig_GetStoredNetworks

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Hämtar alla lagrade Wi-Fi nätverk på enheten. Den här funktionen är inte trådsäker.

Observera

Innan du anropar WifiConfig_GetStoredNetworks måste du anropa WifiConfig_GetStoredNetworkCount och använda resultatet som matrisstorlek för den WifiConfig_StoredNetwork matris som överförs som storedNetworkArray parameter.

  • Om storedNetworkArray den här funktionen är för liten för att innehålla alla lagrade Wi-Fi nätverk fyller den matrisen och returnerar antalet matriselement.

  • Om WiFiConfig-funktionen inte finns returnerar funktionen en tom matris.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parametrar

  • storedNetworkArray En pekare till en matris som returnerar den lagrade Wi-Fi nätverk.

  • storedNetworkArrayCount Antalet element storedNetworkArray kan innehålla. Matrisen bör ha ett element för varje lagrat Wi-Fi nätverk.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: programmanifestet innehåller inte WifiConfig-funktionen.

  • EFAULT: parametern storedNetworkArray är NULL.

  • ERANGE: parametern storedNetworkArrayCount är 0.

  • EINVAL: parametern storedNetworkArray eller dess struct-version är ogiltig.

  • EAGAIN: Wi-Fi-enheten är inte klar än.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar antalet element i den WifiConfig_StoredNetwork matrisen, eller -1 för fel, i vilket fall errno felvärdet är inställt.

Krav för programmanifest

Programmanifestet måste innehålla WifiConfig-funktionen.