Sdílet prostřednictvím

WifiConfig_SetPSK funkce

  • Článek

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

Nastaví předsdílený klíč (PSK) pro Wi-Fi síť. PsK se používá pro sítě, které jsou nakonfigurované s typem WifiConfig_Security_Wpa2_Psk zabezpečení.

Nastavení je účinné okamžitě, ale nezachová se při restartování zařízení, pokud se po této funkci nezavolá funkce WifiConfig_PersistConfig .

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

Parametry

  • networkId ID sítě, kterou chcete nakonfigurovat. WifiConfig_AddNetwork vrátí ID sítě.

  • psk Ukazatel na vyrovnávací paměť, která obsahuje sadu PSK pro síť.

  • pskLength Délka sady PSK pro síť. Tento parametr musí být menší než nebo roven WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

Chyby

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

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

  • EFAULT: psk Parametr je NULL.

  • ERANGE: pskLength parametr je větší než WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

  • EAGAIN: zařízení Wi-Fi není připravené.

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

  • EINVAL: networkId Parametr je neplatný.

  • ENODEV: networkId Parametr neodpovídá žádnému z ID uložených sítí.

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.