Dela via

funktionen WifiConfig_SetPSK

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Anger den fördelade nyckeln (PSK) för ett Wi-Fi nätverk. PSK används för nätverk som har konfigurerats med WifiConfig_Security_Wpa2_Psk säkerhetstypen.

Inställningen börjar gälla omedelbart men finns inte kvar på alla enhetsstarter om inte funktionen WifiConfig_PersistConfig anropas efter den här funktionen.

static int WifiConfig_SetPSK(int networkId, const char *psk, size_t pskLength);

Parametrar

  • networkId ID för nätverket som ska konfigureras. WifiConfig_AddNetwork returnerar nätverks-ID: et.

  • psk En pekare till bufferten som innehåller nätverkets PSK.

  • pskLength Längden på PSK för nätverket. Den här parametern måste vara mindre än eller lika med WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: programmanifestet innehåller inte WifiConfig-funktionen.

  • EFAULT: parametern psk är NULL.

  • ERANGE: parametern pskLength är större än WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

  • EAGAIN: Wi-Fi-enheten är inte klar.

  • ENETDOWN: det Wi-Fi nätverksgränssnittet är inte tillgängligt.

  • EINVAL: parametern networkId är ogiltig.

  • ENODEV: parametern networkId matchar inte något av ID:na för de lagrade nätverken.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar 0 för lyckat resultat, eller -1 för fel, i vilket fall errno är inställt på felvärdet.

Krav för programmanifest

Programmanifestet måste innehålla WifiConfig-funktionen.