WifiConfig_SetPSK functie

Header: #include <applibs/wificonfig.h>

Hiermee stelt u de vooraf gedeelde sleutel (PSK) voor een Wi-Fi-netwerk in. De PSK wordt gebruikt voor netwerken die zijn geconfigureerd met het WifiConfig_Security_Wpa2_Psk beveiligingstype.

De instelling is onmiddellijk van kracht, maar blijft niet behouden wanneer het apparaat opnieuw wordt opgestart, tenzij de functie WifiConfig_PersistConfig wordt aangeroepen na deze functie.

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

Parameters

• networkId De id van het netwerk dat moet worden geconfigureerd. WifiConfig_AddNetwork retourneert de netwerk-id.

• psk Een aanwijzer naar de buffer die de PSK voor het netwerk bevat.

• pskLength De lengte van de PSK voor het netwerk. Deze parameter moet kleiner zijn dan of gelijk zijn aan WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

• EACCES: het toepassingsmanifest bevat niet de mogelijkheid WifiConfig.

• EFAULT: de psk parameter is NULL.

• ERANGE: de pskLength parameter is groter dan WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

• EAGAIN: het Wi-Fi apparaat is niet gereed.

• ENETDOWN: de Wi-Fi netwerkinterface is niet beschikbaar.

• EINVAL: de networkId parameter is ongeldig.

• ENODEV: de networkId parameter komt niet overeen met een van de id's van de opgeslagen netwerken.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet bewaard via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.