WifiConfig_ForgetNetwork İşlevi
Ü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.