Funzione WifiConfig_AddNetworkWifiConfig_AddNetwork Function

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

Aggiunge una rete Wi-Fi al dispositivo e restituisce l'ID della rete.Adds a Wi-Fi network to the device and returns the ID of the network.

int WifiConfig_AddNetwork(void);

ErroriErrors

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 doesn't include the WifiConfig capability.

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

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

  • ENOMEM: non è disponibile memoria sufficiente per aggiungere una nuova rete.ENOMEM: there is not enough memory to add a new network.

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 l'ID della nuova rete oppure-1 per l'errore, nel qual caso errno viene impostato sul valore di errore.Returns the ID of the new network, or -1 for failure, in which case errno is set to the error value. L'ID rete è zero o un valore positivo.The network ID is zero or a positive value.

OsservazioniRemarks

L'ID di rete viene passato alle funzioni *WifiConfig_Set * _, ad esempio WifiConfig_SetSSID.The network ID is passed to *WifiConfig_Set* _ functions, such as WifiConfig_SetSSID.

La nuova rete non è configurata e può essere configurata con le funzioni _ *WifiConfig_Set ***.The new network isn't configured and can be configured with the _ WifiConfig_Set** functions. Le modifiche apportate alla configurazione di rete vengono applicate immediatamente, ma vengono perse al riavvio del dispositivo, a meno che non venga chiamata la funzione WifiConfig_PersistConfig per salvare la configurazione nella memoria non volatile.Changes to the network configuration are effective immediately but are lost when the device reboots unless the WifiConfig_PersistConfig function is called to save the configuration to nonvolatile storage.

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.The number of networks you can store on a device is not fixed, but depends on the available resources and the amount of storage required for each network configuration.

Requisiti del manifesto dell'applicazioneApplication manifest requirements

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