Udostępnij za pośrednictwem

funkcja WifiConfig_SetConfigName

  • Artykuł

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

Ustawia nazwę konfiguracji sieci. Nazwa może być używana jako wygodny uchwyt do identyfikowania konfiguracji sieci. Zdecydowanie zaleca się, aby ta nazwa była unikatowa.

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_SetConfigName(int networkId, const char *configName);

Parametry

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

  • configname Wskaźnik do tablicy bajtów zawierającej nazwę konfiguracji. Tablica bajtów musi być zakończona wartością NULL i być mniejsza lub równa bajtom WIFICONFIG_CONFIG_NAME_MAX_LENGTH (z wyjątkiem zakończenia).

Błędy

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

  • EACCES: manifest aplikacji nie zawiera funkcji WifiConfig.

  • EFAULT: configName parametr ma wartość NULL.

  • ERANGE: configName parametr jest większy niż WIFICONFIG_CONFIG_NAME_MAX_LENGTH.

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