Udostępnij za pośrednictwem

Funkcja WifiConfig_ForgetNetwork

  • Artykuł

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

Ważne

Ta funkcja jest przestarzała. Zamiast tego użyj WifiConfig_ForgetNetworkById .

Usuwa z urządzenia sieć Wi-Fi. Odłącza urządzenie od sieci, jeśli jest obecnie podłączone. Ta funkcja nie jest bezpieczna dla wątków.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parametry

Błędy

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

  • EACCES: manifest aplikacji nie zawiera funkcji WifiConfig.

  • EFAULT: ssid parametr ma wartość NULL.

  • ENOENT: storedNetwork parametr nie odpowiada żadnej z przechowywanych sieci.

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

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

  • ENETDOWN: Wi-Fi interfejs sieciowy jest niedostępny.

  • ENOSPC: istnieje zbyt wiele sieci Wi-Fi, aby konfiguracja się utrzymywała; usuń jeden z nich i spróbuj ponownie.

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 wartość 0 dla powodzenia 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.