Funzione WifiConfig_ForgetNetwork

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Importante

Questa funzione è obsoleta. Usare invece WifiConfig_ForgetNetworkById .

Rimuove una rete Wi-Fi dal dispositivo. Disconnette il dispositivo dalla rete se è attualmente connesso. Questa funzione non è thread-safe.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parametri

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EACCES: il manifesto dell'applicazione non include la funzionalità WifiConfig.

  • EFAULT: il ssid parametro è NULL.

  • ENOENT: il storedNetwork parametro non corrisponde a nessuna delle reti archiviate.

  • EINVAL: il storedNetwork parametro o la versione struct non è valida.

  • EAGAIN: il dispositivo Wi-Fi non è ancora pronto.

  • ENETDOWN: l'interfaccia di rete Wi-Fi non è disponibile.

  • ENOSPC: ci sono troppe reti Wi-Fi per il perdurare della configurazione; rimuoverne uno e riprovare.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce 0 per operazione riuscita o -1 per errore, nel qual caso errno è impostato sul valore di errore.

Requisiti del manifesto dell'applicazione

Il manifesto dell'applicazione deve includere la funzionalità WifiConfig.