Share via

WifiConfig_ForgetNetworkById İşlevi

  • Makale

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

Cihazdan bir Wi-Fi ağı kaldırır. Şu anda bağlıysa cihazın ağ bağlantısını keser.

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.

int WifiConfig_ForgetNetworkById(int networkId);

Parametre

  • networkId Kaldırılacak ağın kimliği.

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.

  • EINVAL: networkId parametre geçersiz.

  • ENOENT: networkId parametresi , depolanan ağların hiçbir kimliğiyle eşleşmiyor.

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

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

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.