Udostępnij za pośrednictwem

Funkcja WifiConfig_StoreWpa2Network

  • Artykuł

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

Ważne

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

Przechowuje sieć Wi-Fi WPA2 używającą wstępnie udostępnionego klucza. Ta funkcja nie jest bezpieczna dla wątków.

Uwaga

Ta funkcja zakończy się niepowodzeniem, jeśli sieć z tym samym identyfikatorem SSID i wstępnie udostępnionym kluczem jest już przechowywana. Zobacz sekcję błędu (EEXIST).

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

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.

  • psk Wskaźnik do buforu zawierającego wstępnie udostępniony klucz sieci Wi-Fi.

  • pskLength Długość wstępnie udostępnionego klucza dla 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 już istnieje, która ma ten sam identyfikator SSID i używa WPA2.

  • EFAULT: lub ssidpsk ma wartość NULL.

  • ERANGE: ssidLength parametr lub pskLength jest 0 lub większy niż WIFICONFIG_SSID_MAX_LENGTH i WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

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