Aracılığıyla paylaş

WifiConfig_GetScannedNetworks İşlevi

  • Makale

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

Son tarama işlemi tarafından bulunan Wi-Fi ağlarını alır. Bu işlev iş parçacığı güvenli değil.

  • Tüm ağları barındırmak için çok küçükse scannedNetworkArray , bu işlev tüm öğeleri 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_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Parametre

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

  • scannedNetworkArrayCount TarananNetworkArray'nin tutabileceği öğe sayısı. Dizi, son tarama işlemi tarafından bulunan her Wi-Fi ağı için bir öğeye sahip 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: scannedNetworkArray parametresi NULL'dir.

  • ERANGE: scannedNetworkArrayCount parametresi 0'dır.

  • EINVAL: scannedNetworkArray 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

taranmışNetworkArray tarafından döndürülen WifiConfig_ScannedNetwork öğelerinin sayısını veya hata için -1 değerini döndürür ve bu durumda errno hata değerine ayarlanır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi WifiConfig özelliğini içermelidir.