Sdílet prostřednictvím

WifiConfig_AddDuplicateNetwork – funkce

  • Článek

Hlavička: #include <applibs/wificonfig.h>

Přidá novou síť, která je duplikátem zadané sítě se zadaným ID. Nová síť má přiřazený zadaný název a ve výchozím nastavení je zakázaná.

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

Parametry

  • networkId ID sítě, kterou chcete duplikovat. WifiConfig_AddNetwork vrátí ID sítě.

  • configName Ukazatel na pole bajtů, které obsahuje název konfigurace. Pole musí mít hodnotu NULL a musí mít maximálně WIFICONFIG_CONFIG_NAME_MAX_LENGTH bajtů s výjimkou znaku ukončení.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

  • EAGAIN: zařízení Wi-Fi není připravené.

  • EEXIST: není configName jedinečný.

  • EFAULT: hodnota configName je NULL.

  • EINVAL: hodnota networkId je neplatná.

  • ENETDOWN: Wi-Fi síťové rozhraní není k dispozici.

  • ENODEV: hodnota networkId neodpovídá žádné z uložených sítí.

  • ENOMEM: Není k dispozici dostatek paměti pro přidání nové sítě.

  • ERANGE: Má configName méně než jeden znak nebo více než WIFICONFIG_CONFIG_NAME_MAX_LENGTH znaků.

Je také možné zadat všechny ostatní errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí ID nové sítě nebo -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu. ID sítě je nula nebo kladná hodnota.

Poznámky

Nová síť není nakonfigurovaná a dá se nakonfigurovat pomocí funkcí WifiConfig_Set* . Změny konfigurace sítě jsou účinné okamžitě, ale při restartování zařízení se ztratí, pokud není volána funkce WifiConfig_PersistConfig pro uložení konfigurace do nevolatilní úložiště.

Počet sítí, které můžete na zařízení uložit, není pevný, ale závisí na dostupných prostředcích a velikosti úložiště vyžadované pro každou konfiguraci sítě.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci WifiConfig.