Sdílet prostřednictvím

funkce WifiConfig_ForgetNetwork

  • Článek

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

Důležité

Tato funkce je zastaralá. Místo toho použijte WifiConfig_ForgetNetworkById .

Odebere ze zařízení Wi-Fi síť. Odpojí zařízení od sítě, pokud je aktuálně připojené. Tato funkce není bezpečná pro přístup z více vláken.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parametry

Chyby

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

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

  • EFAULT: ssid Parametr je NULL.

  • ENOENT: storedNetwork Parametr neodpovídá žádné z uložených sítí.

  • EINVAL: storedNetwork Parametr nebo jeho verze struktury jsou neplatné.

  • EAGAIN: zařízení Wi-Fi ještě není připravené.

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

  • ENOSPC: existuje příliš mnoho Wi-Fi sítí, aby se konfigurace zachovala; odeberte jeden a zkuste to znovu.

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.