Funzione WifiConfig_AddDuplicateNetwork

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Aggiunge una nuova rete duplicata della rete specificata con l'ID specificato. Alla nuova rete viene assegnato il nome specificato ed è disabilitata per impostazione predefinita.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

Parametri

  • networkId ID della rete da duplicare. WifiConfig_AddNetwork restituisce l'ID di rete.

  • configName Puntatore a una matrice di byte che contiene il nome di configurazione. La matrice deve essere terminata con un valore NULL e al massimo WIFICONFIG_CONFIG_NAME_MAX_LENGTH byte, escluso il carattere di terminazione.

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.

  • EEXIST: il configName non è univoco.

  • EFAULT: è configName NULL.

  • EINVAL: non networkId è valido.

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

  • ENODEV: networkId il non corrisponde a nessuna delle reti archiviate.

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

  • ERANGE: ha configName meno di un carattere o più di WIFICONFIG_CONFIG_NAME_MAX_LENGTH caratteri.

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

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.