WifiConfig_SetPSK İşlevi

  • Makale

Üst bilgi: #include <applibs/wificonfig.h>

Wi-Fi ağı için önceden paylaşılan anahtarı (PSK) ayarlar. PSK, güvenlik türüyle WifiConfig_Security_Wpa2_Psk yapılandırılmış ağlar için kullanılır.

Ayar hemen etkindir ancak bu işlevden sonra WifiConfig_PersistConfig işlevi çağrılmadığı sürece cihaz yeniden başlatmalarında kalıcı olmaz.

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

Parametre

  • networkId Yapılandırılan ağın kimliği. WifiConfig_AddNetwork ağ kimliğini döndürür.

  • psk Ağ için PSK'yi içeren arabelleğe yönelik bir işaretçi.

  • pskLength Ağ için PSK uzunluğu. Bu parametrenin değerinden küçük veya eşit WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZEolması gerekir.

Hata

Hatayla karşılaşılırsa ve hata değerine ayarlanırsa errno -1 döndürür.

  • EACCES: Uygulama bildirimi WifiConfig özelliğini içermez.

  • EFAULT: psk parametresi NULL'dir.

  • ERANGE: parametresi değerinden pskLengthWIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZEbüyüktür.

  • EAGAIN: Wi-Fi cihazı hazır değil.

  • ENETDOWN: Wi-Fi ağ arabirimi kullanılamıyor.

  • EINVAL: networkId parametre geçersiz.

  • ENODEV: networkId parametresi depolanan ağların kimlikleriyle eşleşmiyor.

Diğer errno hatalar da belirtilebilir; bu tür hatalar belirlenimci değildir ve sistem güncelleştirmeleri aracılığıyla aynı davranış korunmayabilir.

Dönüş değeri

Başarı için 0 veya hata için -1 döndürür; bu durumda errno hata değerine ayarlanır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi WifiConfig özelliğini içermelidir.