Udostępnij za pośrednictwem

Funkcja WifiConfig_GetScannedNetworks

  • Artykuł

Nagłówek: #include <applibs/wificonfig.h>

Pobiera Wi-Fi sieci znalezione podczas ostatniej operacji skanowania. Ta funkcja nie jest bezpieczna dla wątków.

  • Jeśli scannedNetworkArray jest zbyt mała, aby pomieścić wszystkie sieci, ta funkcja wypełnia wszystkie elementy i zwraca liczbę elementów tablicy.

  • Jeśli funkcja WiFiConfig nie jest dostępna, funkcja zwraca pustą tablicę.

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Parametry

  • scannedNetworkArray Wskaźnik do tablicy zwracającej pobrane Wi-Fi sieci.

  • scannedNetworkArrayCount Liczba elementów zeskanowanychNetworkArray może zawierać. Tablica powinna mieć jeden element dla każdej Wi-Fi sieci znalezionej podczas ostatniej operacji skanowania.

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EACCES: manifest aplikacji nie zawiera funkcji WifiConfig.

  • EFAULT: scannedNetworkArray parametr ma wartość NULL.

  • ERANGE: scannedNetworkArrayCount parametr ma wartość 0.

  • EINVAL: scannedNetworkArray parametr lub jego wersja struktury jest nieprawidłowa.

  • EAGAIN: urządzenie Wi-Fi nie jest jeszcze gotowe.

Mogą być również określone inne errno błędy; takie błędy nie są deterministyczne i to samo zachowanie może nie być zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca liczbę elementów WifiConfig_ScannedNetwork zwracanych przez zeskanowaną tabelęNetworkArray lub -1 w przypadku niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję WifiConfig.