Udostępnij za pośrednictwem

Funkcja WifiConfig_StoreOpenNetwork

  • Artykuł

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

Ważne

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

Przechowuje otwartą sieć Wi-Fi bez użycia klucza. Ta funkcja nie jest bezpieczna dla wątków.

Ta funkcja zakończy się niepowodzeniem, jeśli identyczna sieć jest już przechowywana na urządzeniu bez klucza. Zobacz sekcję błędu (EEXIST). Jeśli jednak sieć przechowywana zawiera klucz wraz z tym samym identyfikatorem SSID, ta funkcja powiedzie się i zapisze sieć.

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

Parametry

  • ssid Wskaźnik do tablicy bajtów SSID z nieokreślonym kodowaniem znaków identyfikującym sieć Wi-Fi.

  • ssidLength Liczba bajtów w identyfikatorze SSID sieci Wi-Fi.

Błędy

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

  • EACCES: manifest aplikacji nie zawiera funkcji WifiConfig.

  • EEXIST: przechowywana sieć Wi-Fi, która ma ten sam identyfikator SSID i nie istnieje już żaden klucz.

  • EFAULT: wartość ssid null.

  • ERANGE: ssidLength jest 0 lub większa niż WIFICONFIG_SSID_MAX_LENGTH.

  • 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.