Funzione WifiConfig_StoreOpenNetwork

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Importante

Questa funzione è obsoleta. Usare invece WifiConfig_AddNetwork .

Archivia una rete Wi-Fi aperta senza chiave. Questa funzione non è thread-safe.

Questa funzione avrà esito negativo se una rete identica è già archiviata nel dispositivo senza chiave. Vedere la sezione degli errori (EEXIST). Tuttavia, se una rete archiviata include una chiave insieme allo stesso SSID, questa funzione avrà esito positivo e archivierà la rete.

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

Parametri

  • ssid Puntatore a una matrice di byte SSID con codifica di caratteri non specificata che identifica la rete Wi-Fi.

  • ssidLength Numero di byte nell'SSID della rete Wi-Fi.

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.

  • EEXIST: una rete Wi-Fi archiviata che ha lo stesso SSID e nessuna chiave esiste già.

  • EFAULT: è ssid NULL.

  • ERANGE: è ssidLength 0 o maggiore di WIFICONFIG_SSID_MAX_LENGTH.

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

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

  • ENOSPC: ci sono troppe reti Wi-Fi per il perdurare della configurazione; rimuoverne uno e riprovare.

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.