Share via

WifiConfig_ForgetNetwork İşlevi

  • Makale

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

Önemli

Bu işlev kullanımdan kaldırıldı. Bunun yerine WifiConfig_ForgetNetworkById kullanın.

Cihazdan bir Wi-Fi ağı kaldırır. Şu anda bağlıysa cihazın ağ bağlantısını keser. Bu işlev iş parçacığı güvenli değil.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parametre

  • storedNetwork Kaldırılacak depolanan Wi-Fi ağının açıklandığı WifiConfig_StoredNetwork yapısına yönelik işaretç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.

  • EFAULT: ssid parametresi NULL'dir.

  • ENOENT: storedNetwork parametresi depolanan ağların hiçbirinde eşleşmiyor.

  • EINVAL: storedNetwork parametre veya yapı sürümü geçersiz.

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

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

  • ENOSPC: Yapılandırmanın kalıcı olması için çok fazla Wi-Fi ağı vardır; kaldırın ve yeniden deneyin.

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.