Udostępnij za pośrednictwem

Funkcja WifiConfig_SetPSK

  • Artykuł

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

Ustawia wstępnie udostępniony klucz (PSK) dla sieci Wi-Fi. Psk jest używany dla sieci, które są skonfigurowane z typem WifiConfig_Security_Wpa2_Psk zabezpieczeń.

To ustawienie jest skuteczne natychmiast, ale nie będzie nadal działać na całym urządzeniu, chyba że funkcja WifiConfig_PersistConfig zostanie wywołana po tej funkcji.

static int WifiConfig_SetPSK(int networkId, const char *psk, size_t pskLength);

Parametry

  • networkId Identyfikator sieci do skonfigurowania. WifiConfig_AddNetwork zwraca identyfikator sieci.

  • psk Wskaźnik do buforu zawierającego psk dla sieci.

  • pskLength Długość psk dla sieci. Ten parametr musi być mniejszy lub równy WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

Błędy

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

  • EACCES: manifest aplikacji nie zawiera funkcji WifiConfig.

  • EFAULT: psk parametr ma wartość NULL.

  • ERANGE: pskLength parametr jest większy niż WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

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

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

  • EINVAL: parametr jest nieprawidłowy networkId .

  • ENODEV: networkId parametr nie odpowiada żadnym identyfikatorom przechowywanych sieci.

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.