funkcja WifiConfig_AddDuplicateNetwork

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

Dodaje nową sieć, która jest duplikatem określonej sieci z określonym identyfikatorem. Nowa sieć ma określoną nazwę i jest domyślnie wyłączona.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

Parametry

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

• configName Wskaźnik do tablicy bajtów zawierającej nazwę konfiguracji. Tablica musi być zakończona null i co najwyżej WIFICONFIG_CONFIG_NAME_MAX_LENGTH bajtów, z wyłączeniem znaku 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.

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

• EEXIST: nie jest unikatowy configName .

• EFAULT: wartość configName null.

• EINVAL: jest nieprawidłowy networkId .

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

• ENODEV: networkId nie odpowiada żadnej z przechowywanych sieci.

• ENOMEM: nie ma wystarczającej ilości pamięci, aby dodać nową sieć.

• ERANGE: configName zawiera mniej niż jeden znak lub więcej niż WIFICONFIG_CONFIG_NAME_MAX_LENGTH znaków.

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 identyfikator nowej sieci lub -1 dla niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu. Identyfikator sieci to zero lub wartość dodatnia.

Uwagi

Nowa sieć nie jest skonfigurowana i można ją skonfigurować przy użyciu funkcji WifiConfig_Set* . Zmiany w konfiguracji sieci są skuteczne natychmiast, ale są tracone po ponownym uruchomieniu urządzenia, chyba że funkcja WifiConfig_PersistConfig jest wywoływana w celu zapisania konfiguracji w pamięci niewolnej.

Liczba sieci, które można przechowywać na urządzeniu, nie jest stała, ale zależy od dostępnych zasobów i ilości miejsca do magazynowania wymaganego dla każdej konfiguracji sieci.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję WifiConfig.