Funzione WifiConfig_AddNetwork

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Aggiunge una rete Wi-Fi al dispositivo e restituisce l'ID della rete.

int WifiConfig_AddNetwork(void);

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.

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

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

  • ENOMEM: la memoria non è sufficiente per aggiungere una nuova rete.

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 l'ID della nuova rete, o -1 per l'errore, nel qual caso errno è impostato sul valore di errore. L'ID di rete è zero o è un valore positivo.

Osservazioni

L'ID di rete viene passato a funzioni WifiConfig_Set* , ad esempio WifiConfig_SetSSID.

La nuova rete non è configurata e può essere configurata con le funzioni WifiConfig_Set* . Le modifiche alla configurazione di rete vengono applicate immediatamente, ma vanno perse al riavvio del dispositivo, a meno che la funzione WifiConfig_PersistConfig non venga chiamata per salvare la configurazione in un archivio non involontario.

Il numero di reti che è possibile archiviare in un dispositivo non è fisso, ma dipende dalle risorse disponibili e dalla quantità di spazio di archiviazione necessaria per ogni configurazione di rete.

Requisiti del manifesto dell'applicazione

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