Sdílet prostřednictvím

funkce WifiConfig_GetScannedNetworks

  • Článek

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

Získá Wi-Fi sítě nalezené poslední operací kontroly. Tato funkce není bezpečná pro přístup z více vláken.

  • Pokud scannedNetworkArray je příliš malý na to, aby podržel všechny sítě, tato funkce vyplní všechny prvky a vrátí počet prvků pole.

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

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Parametry

  • scannedNetworkArray Ukazatel na pole, které vrací načtené Wi-Fi sítě.

  • scannedNetworkArrayCount Počet prvků scannedNetworkArray může obsahovat. Pole by mělo mít jeden prvek pro každou Wi-Fi síť nalezenou poslední operací kontroly.

Chyby

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

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

  • EFAULT: scannedNetworkArray Parametr je NULL.

  • ERANGE: scannedNetworkArrayCount parametr je 0.

  • EINVAL: scannedNetworkArray 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 WifiConfig_ScannedNetwork elementů vrácených pomocí scannedNetworkArray 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.