WifiConfig_SetSSID İşlevi

  • Makale

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

Wi-Fi ağı için SSID'yi ayarlar.

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_SetSSID(int networkId, const uint8_t *ssid, size_t ssidLength);

Parametre

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

  • ssid Yeni SSID'yi içeren bayt dizisinin işaretçisi. Karakter kodlaması belirtilmemiş.

  • ssidLength Parametresindeki ssid bayt sayısı. değerinden küçük veya eşit WIFICONFIG_SSID_MAX_LENGTHolmalıdır.

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: ssid parametresi NULL'dir.

  • ERANGE: parametresi değerinden ssidLengthWIFICONFIG_SSID_MAX_LENGTHbü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.