Share via

WifiConfig_GetStoredNetworks İşlevi

  • Makale

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

Cihazdaki tüm depolanan Wi-Fi ağlarını alır. Bu işlev iş parçacığı güvenli değil.

Not

WifiConfig_GetStoredNetworks çağırmadan önce, WifiConfig_GetStoredNetworkCount çağırmanız ve parametre olarak geçirilen WifiConfig_StoredNetwork dizisinin dizi boyutu olarak storedNetworkArray sonucu kullanmanız gerekir.

  • Depolanan tüm Wi-Fi ağlarını tutamayacak kadar küçükse storedNetworkArray , bu işlev diziyi doldurur ve dizi öğelerinin sayısını döndürür.

  • WiFiConfig özelliği yoksa işlev boş bir dizi döndürür.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parametre

  • storedNetworkArray Depolanan Wi-Fi ağlarını döndüren bir dizi işaretçisi.

  • storedNetworkArrayCount Tutulabilecek öğe storedNetworkArray sayısı. Dizinin her depolanan Wi-Fi ağı için bir öğesi 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.

  • EFAULT: storedNetworkArray parametresi NULL'dir.

  • ERANGE: storedNetworkArrayCount parametresi 0'dır.

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

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

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

WifiConfig_StoredNetwork dizisindeki öğe sayısını veya hata için -1 değerini döndürür; bu durumda errno hata değerine ayarlanır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi WifiConfig özelliğini içermelidir.