WifiConfig_GetStoredNetworks functie

Header: #include <applibs/wificonfig.h>

Haalt alle opgeslagen Wi-Fi netwerken op het apparaat op. Deze functie is niet thread-veilig.

Opmerking

Voordat u WifiConfig_GetStoredNetworks aanroept, moet u WifiConfig_GetStoredNetworkCount aanroepen en het resultaat gebruiken als de matrixgrootte voor de WifiConfig_StoredNetwork matrix die als parameter storedNetworkArray wordt doorgegeven.

• Als storedNetworkArray te klein is voor alle opgeslagen Wi-Fi netwerken, vult deze functie de matrix en retourneert het aantal matrixelementen.

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

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parameters

• storedNetworkArray Een aanwijzer naar een matrix die de opgeslagen Wi-Fi netwerken retourneert.

• storedNetworkArrayCount Het aantal elementen storedNetworkArray dat kan worden opgeslagen. De matrix moet één element bevatten voor elke opgeslagen 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.

• EFAULT: de storedNetworkArray parameter is NULL.

• ERANGE: de storedNetworkArrayCount parameter is 0.

• EINVAL: de storedNetworkArray 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 elementen in de WifiConfig_StoredNetwork matrix, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.