Sdílet prostřednictvím

funkce WifiConfig_SetConfigName

  • Článek

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

Nastaví název konfigurace sítě. Název lze použít jako pohodlný popisovač pro identifikaci konfigurace sítě. Důrazně doporučujeme, aby tento název byl jedinečný.

Nastavení je účinné okamžitě, ale nezachová se při restartování zařízení, pokud se po této funkci nezavolá funkce WifiConfig_PersistConfig .

static int WifiConfig_SetConfigName(int networkId, const char *configName);

Parametry

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

  • configname Ukazatel na pole bajtů obsahující název konfigurace. Pole bajtů musí mít ukončenou hodnotu NULL a musí být menší než nebo rovno WIFICONFIG_CONFIG_NAME_MAX_LENGTH bajtům (s výjimkou ukončení).

Chyby

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

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

  • EFAULT: configName Parametr je NULL.

  • ERANGE: configName parametr je větší než WIFICONFIG_CONFIG_NAME_MAX_LENGTH.

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

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

  • EINVAL: networkId Parametr je neplatný.

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

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í hodnotu 0 pro úspěch nebo -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci WifiConfig.