Condividi tramite

Funzione WifiConfig_SetConfigName

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Imposta un nome per una configurazione di rete. Il nome può essere usato come pratico handle per identificare una configurazione di rete. È consigliabile che questo nome sia univoco.

L'impostazione è immediatamente valida, ma non viene mantenuta nei riavvii del dispositivo, a meno che la funzione WifiConfig_PersistConfig non venga chiamata dopo questa funzione.

static int WifiConfig_SetConfigName(int networkId, const char *configName);

Parametri

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

  • configname Puntatore a una matrice di byte contenente il nome di configurazione. La matrice di byte deve essere terminata con valore NULL ed essere minore o uguale a WIFICONFIG_CONFIG_NAME_MAX_LENGTH byte (esclusa la 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.

  • EFAULT: il configName parametro è NULL.

  • ERANGE: il configName parametro è maggiore di WIFICONFIG_CONFIG_NAME_MAX_LENGTH.

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

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

  • EINVAL: il networkId parametro non è valido.

  • ENODEV: il networkId parametro non corrisponde a nessuno degli ID delle reti archiviate.

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.