Dela via

funktionen WifiConfig_GetScannedNetworks

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Hämtar de Wi-Fi nätverk som hittades vid den senaste genomsökningen. Den här funktionen är inte trådsäker.

  • Om scannedNetworkArray det är för litet för att hålla alla nätverk fylls alla element i den här funktionen och antalet matriselement returneras.

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

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Parametrar

  • scannedNetworkArray En pekare till en matris som returnerar den hämtade Wi-Fi nätverk.

  • scannedNetworkArrayCount Antalet skannade elementNetworkArray kan innehålla. Matrisen bör ha ett element för varje Wi-Fi nätverk som hittades vid den senaste genomsökningen.

Fel

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

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

  • EFAULT: parametern scannedNetworkArray är NULL.

  • ERANGE: parametern scannedNetworkArrayCount är 0.

  • EINVAL: parametern scannedNetworkArray 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 WifiConfig_ScannedNetwork element som returneras av skannadeNetworkArray, eller -1 för fel, i vilket fall errno är inställt på felvärdet.

Krav för programmanifest

Programmanifestet måste innehålla WifiConfig-funktionen.