funktionen WifiConfig_StoreWpa2Network

Sidhuvud: #include <applibs/wificonfig.h>

Viktigt

Den här funktionen är föråldrad. Använd WifiConfig_AddNetwork i stället.

Lagrar ett WPA2-Wi-Fi nätverk som använder en fördelad nyckel. Den här funktionen är inte trådsäker.

Observera

Den här funktionen misslyckas om ett nätverk med samma SSID och fördelad nyckel redan har lagrats. Se felavsnittet (EEXIST).

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

Parametrar

ssid En pekare till en SSID-bytematris med ospecificerad teckenkodning som identifierar det Wi-Fi nätverket.
ssidLength Antalet byte i SSID för det Wi-Fi nätverket.
psk En pekare till en buffert som innehåller den fördelade nyckeln för det Wi-Fi nätverket.
pskLength Längden på den fördelade nyckeln för det Wi-Fi nätverket.

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

EACCES: programmanifestet innehåller inte WifiConfig-funktionen.
EEXIST: det finns redan ett lagrat Wi-Fi nätverk som har samma SSID och använder WPA2.
EFAULT: eller ssidpsk är NULL.
ERANGE: parametern ssidLength eller pskLength är 0 eller större än WIFICONFIG_SSID_MAX_LENGTH och WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.
EAGAIN: Wi-Fi-enheten är inte klar än.
ENETDOWN: det Wi-Fi nätverksgränssnittet är inte tillgängligt.
ENOSPC: det finns för många Wi-Fi nätverk för att konfigurationen ska bevaras. ta bort en och försök igen.

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

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

Programmanifestet måste innehålla WifiConfig-funktionen.