Aracılığıyla paylaş


WifiConfig_AddDuplicateNetwork İşlevi

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

Belirtilen kimliğiyle belirtilen ağın yinelemesi olan yeni bir ağ ekler. Yeni ağa belirtilen ad atanır ve varsayılan olarak devre dışı bırakılır.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

Parametre

  • networkId Çoğaltacak 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. Dizi null olarak sonlandırılmalıdır ve sonlandırma karakteri hariç en fazla WIFICONFIG_CONFIG_NAME_MAX_LENGTH bayt 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.

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

  • EEXIST: configName benzersiz değildir.

  • EFAULT: the configName is NULL.

  • EINVAL: networkId geçersiz.

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

  • ENODEV: saklı networkId ağların hiçbirinde eşleşmez.

  • ENOMEM: Yeni ağ eklemek için yeterli bellek yok.

  • ERANGE: bir configName karakterden az veya WIFICONFIG_CONFIG_NAME_MAX_LENGTH karakterden fazladır.

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

Yeni ağın kimliğini veya hata için -1 değerini döndürür; bu durumda errno hata değeri olarak ayarlanır. Ağ kimliği sıfır veya pozitif bir değerdir.

Açıklamalar

Yeni ağ yapılandırılmaz ve WifiConfig_Set* işlevleriyle yapılandırılabilir. Ağ yapılandırmasında yapılan değişiklikler hemen etkili olur, ancak WifiConfig_PersistConfig işlevi yapılandırmayı geçici olmayan depolama alanına kaydetmek için çağrılmadığı sürece cihaz yeniden başlatıldığında kaybolur.

Bir cihazda depolayabileceğiniz ağ sayısı sabit değildir, ancak kullanılabilir kaynaklara ve her ağ yapılandırması için gereken depolama miktarına bağlıdır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi WifiConfig özelliğini içermelidir.