Udostępnij za pośrednictwem

Funkcja WifiConfig_GetStoredNetworks

  • Artykuł

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

Pobiera wszystkie przechowywane Wi-Fi sieci na urządzeniu. Ta funkcja nie jest bezpieczna dla wątków.

Uwaga

Przed wywołaniem WifiConfig_GetStoredNetworks należy wywołać WifiConfig_GetStoredNetworkCount i użyć wyniku jako rozmiaru tablicy dla tablicy WifiConfig_StoredNetwork , która jest przekazywana jako storedNetworkArray parametr.

  • Jeśli storedNetworkArray jest zbyt mała, aby pomieścić wszystkie przechowywane Wi-Fi sieci, ta funkcja wypełnia tablicę i zwraca liczbę elementów tablicy.

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

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parametry

  • storedNetworkArray Wskaźnik do tablicy zwracającej przechowywane Wi-Fi sieci.

  • storedNetworkArrayCount Liczba elementów storedNetworkArray , które można przechowywać. Tablica powinna mieć jeden element dla każdego przechowywanego Wi-Fi sieci.

Błędy

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

  • EACCES: manifest aplikacji nie zawiera funkcji WifiConfig.

  • EFAULT: storedNetworkArray parametr ma wartość NULL.

  • ERANGE: storedNetworkArrayCount parametr ma wartość 0.

  • EINVAL: storedNetworkArray 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 w tablicy WifiConfig_StoredNetwork lub -1 dla niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję WifiConfig.