Sdílet prostřednictvím

WifiConfig_GetStoredNetworks Funkce

  • Článek

Hlavička: #include <applibs/wificonfig.h>

Načte všechny uložené Wi-Fi sítě v zařízení. Tato funkce není bezpečná pro přístup z více vláken.

Poznámka

Před voláním WifiConfig_GetStoredNetworks je nutné volat WifiConfig_GetStoredNetworkCount a použít výsledek jako velikost pole WifiConfig_StoredNetwork , která je předána jako storedNetworkArray parametr.

  • Pokud storedNetworkArray je příliš malý pro uložení všech uložených Wi-Fi sítí, tato funkce vyplní pole a vrátí počet prvků matice.

  • Pokud funkce WiFiConfig není k dispozici, funkce vrátí prázdné pole.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parametry

  • storedNetworkArray Ukazatel na pole, které vrací uložené Wi-Fi sítě.

  • storedNetworkArrayCount Počet prvků, které storedNetworkArray může obsahovat. Pole by mělo mít jeden prvek pro každou uloženou Wi-Fi síť.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

  • EFAULT: storedNetworkArray Parametr je NULL.

  • ERANGE: storedNetworkArrayCount parametr je 0.

  • EINVAL: storedNetworkArray Parametr nebo jeho verze struktury jsou neplatné.

  • EAGAIN: zařízení Wi-Fi ještě není připravené.

Je také možné zadat všechny ostatní errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí počet prvků v WifiConfig_StoredNetwork matici nebo -1 pro selhání. V tomto případě errno je nastavena na chybovou hodnotu.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci WifiConfig.