Share via


WifiConfig_AddNetwork İşlevi

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

Cihaza bir Wi-Fi ağı ekler ve ağın kimliğini döndürür.

int WifiConfig_AddNetwork(void);

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.

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

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

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

Ağ kimliği, WifiConfig_SetSSID gibi WifiConfig_Set* işlevlere geçirilir.

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.