Sdílet prostřednictvím

WifiConfig_StoreWpa2Network funkce

  • Článek

Hlavička: #include <applibs/wificonfig.h>

Důležité

Tato funkce je zastaralá. Místo toho použijte WifiConfig_AddNetwork .

Ukládá síť WPA2 Wi-Fi, která používá předsdílený klíč. Tato funkce není bezpečná pro přístup z více vláken.

Poznámka

Tato funkce selže, pokud je už síť se stejným identifikátorem SSID a předsdíleným klíčem uložená. Projděte si část s chybami (EEXIST).

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

Parametry

  • ssid Ukazatel na pole SSID bajtů s neurčitým kódováním znaků, které identifikuje Wi-Fi síť.

  • ssidLength Počet bajtů v SSID sítě Wi-Fi.

  • psk Ukazatel na vyrovnávací paměť, která obsahuje předsdílený klíč pro Wi-Fi síť.

  • pskLength Délka předsdíleného klíče pro Wi-Fi síť.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

  • EEXIST: Uložená Wi-Fi síť již existuje, která má stejný identifikátor SSID a používá WPA2.

  • EFAULT: hodnota ssid nebo psk je NULL.

  • ERANGE: ssidLength parametr nebo pskLength je 0 nebo větší než WIFICONFIG_SSID_MAX_LENGTH a WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

  • EAGAIN: zařízení Wi-Fi ještě není připravené.

  • ENETDOWN: Wi-Fi síťové rozhraní není k dispozici.

  • ENOSPC: existuje příliš mnoho Wi-Fi sítí, aby se konfigurace zachovala; odeberte jeden a zkuste to znovu.

Je také možné zadat všechny ostatní errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí hodnotu 0 pro úspěch nebo -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci WifiConfig.