WifiConfig_GetScannedNetworks functie

Header: #include <applibs/wificonfig.h>

Hiermee haalt u de Wi-Fi netwerken op die tijdens de laatste scanbewerking zijn gevonden. Deze functie is niet thread-veilig.

• Als scannedNetworkArray deze functie te klein is voor alle netwerken, vult deze functie alle elementen op en retourneert het aantal matrixelementen.

• Als de WiFiConfig-functie niet aanwezig is, retourneert de functie een lege matrix.

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Parameters

• scannedNetworkArray Een aanwijzer naar een matrix die de opgehaalde Wi-Fi netwerken retourneert.

• scannedNetworkArrayCount Het aantal elementen dat is gescandNetworkArray kan bevatten. De matrix moet één element bevatten voor elke Wi-Fi netwerk dat tijdens de laatste scanbewerking is gevonden.

Fouten

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

• EACCES: het toepassingsmanifest bevat niet de mogelijkheid WifiConfig.

• EFAULT: de scannedNetworkArray parameter is NULL.

• ERANGE: de scannedNetworkArrayCount parameter is 0.

• EINVAL: de scannedNetworkArray parameter of de bijbehorende struct-versie is ongeldig.

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

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

Retourwaarde

Retourneert het aantal WifiConfig_ScannedNetwork elementen dat wordt geretourneerd door scandNetworkArray, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.