WifiConfig_SetSSID İşlevi
Ü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
Parametresindekissid
bayt sayısı. değerinden küçük veya eşitWIFICONFIG_SSID_MAX_LENGTH
olmalı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
ssidLength
WIFICONFIG_SSID_MAX_LENGTH
bü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.