Funzione WifiConfig_ForgetNetworkWifiConfig_ForgetNetwork Function

Intestazione: #include <applibs/wificonfig.h>Header: #include <applibs/wificonfig.h>

Importante

questa funzione è obsoleta.This function is obsolete. In sostituzione, usare WifiConfig_ForgetNetworkById.Use WifiConfig_ForgetNetworkById instead.

Consente di rimuovere una rete Wi-Fi dal dispositivo.Removes a Wi-Fi network from the device. Se il dispositivo è attualmente connesso, lo disconnette dalla rete.Disconnects the device from the network if it's currently connected. Questa funzione non è thread-safe.This function is not thread safe.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

ParametriParameters

ErrorsErrors

Restituisce-1 se viene rilevato un errore e imposta sul errno valore di errore.Returns -1 if an error is encountered and sets errno to the error value.

  • EACCES: il manifesto dell'applicazione non include la funzionalità WifiConfig.EACCES: the application manifest does not include the WifiConfig capability.

  • EFAULT: il parametro ssid è NULL.EFAULT: the ssid parameter is NULL.

  • ENOENT: il parametro storedNetwork non corrisponde a nessuna delle reti archiviate.ENOENT: the storedNetwork parameter doesn't match any of the stored networks.

  • EINVAL: il parametro storedNetwork o la versione dello struct non è valida.EINVAL: the storedNetwork parameter or its struct version is invalid.

  • EAGAIN: il dispositivo Wi-Fi non è ancora pronto.EAGAIN: the Wi-Fi device isn't ready yet.

  • ENETDOWN: l'interfaccia di rete Wi-Fi non è disponibile.ENETDOWN: the Wi-Fi network interface is unavailable.

  • ENOSPC: sono presenti troppe reti Wi-Fi per il salvataggio permanente della configurazione. Rimuoverne una e riprovare.ENOSPC: there are too many Wi-Fi networks for the configuration to persist; remove one and try again.

errnoÈ possibile specificare anche qualsiasi altro tipo di errore. tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti del sistema.Any other errno may also be specified; such errors aren't deterministic and the same behavior might not be retained through system updates.

Valore restituitoReturn value

Restituisce 0 per l'esito positivo o-1 per l'esito negativo, nel qual caso errno viene impostato sul valore di errore.Returns 0 for success, or -1 for failure, in which case errno is set to the error value.

Requisiti del manifesto dell'applicazioneApplication manifest requirements

Il manifesto dell'applicazione deve includere la funzionalità WifiConfig.The application manifest must include the WifiConfig capability.