Funzione WifiConfig_SetSSID

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Imposta l'SSID per una rete Wi-Fi.

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_SetSSID(int networkId, const uint8_t *ssid, size_t ssidLength);

Parametri

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

  • ssid Puntatore a una matrice di byte che contiene il nuovo SSID. La codifica dei caratteri non è specificata.

  • ssidLength Numero di byte nel ssid parametro. Deve essere minore o uguale a WIFICONFIG_SSID_MAX_LENGTH.

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 ssid parametro è NULL.

  • ERANGE: il ssidLength parametro è maggiore di WIFICONFIG_SSID_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.