WifiConfig_SetConfigName İşlevi
Üst bilgi: #include <applibs/wificonfig.h>
Ağ yapılandırması için bir ad ayarlar. Ad, bir ağ yapılandırmasını tanımlamak için kullanışlı bir tanıtıcı olarak kullanılabilir. Bu adın benzersiz olması kesinlikle önerilir.
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_SetConfigName(int networkId, const char *configName);
Parametre
networkId
Yapılandırılan ağın kimliği. WifiConfig_AddNetwork ağ kimliğini döndürür.configname
Yapılandırma adını içeren bir bayt dizisinin işaretçisi. Bayt dizisi NULL olarak sonlandırılmalıdır ve bayttan küçük veya bayt değerineWIFICONFIG_CONFIG_NAME_MAX_LENGTH
eşit olmalıdır (sonlandırma hariç).
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:
configName
parametresi NULL'dir.ERANGE: parametresi değerinden
configName
WIFICONFIG_CONFIG_NAME_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.