Funzione WifiConfig_SetPSK

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Imposta la chiave pre-condivisa (PSK) per una rete Wi-Fi. La tastiera su schermo viene utilizzata per le reti configurate con il WifiConfig_Security_Wpa2_Psk tipo di sicurezza.

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_SetPSK(int networkId, const char *psk, size_t pskLength);

Parametri

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

  • psk Puntatore al buffer che contiene la tastiera su schermo per la rete.

  • pskLength Lunghezza della tastiera su schermo per la rete. Questo parametro deve essere minore o uguale a WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

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

  • ERANGE: il pskLength parametro è maggiore di WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

  • 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.