Bagikan melalui

Fungsi WifiConfig_GetStoredNetworks

  • Artikel

Header: #include <applibs/wificonfig.h>

Mengambil semua jaringan Wi-Fi yang disimpan di perangkat. Fungsi ini tidak aman untuk utas.

Catatan

Sebelum memanggil WifiConfig_GetStoredNetworks, Anda harus memanggil WifiConfig_GetStoredNetworkCount dan menggunakan hasilnya sebagai ukuran array untuk array WifiConfig_StoredNetwork yang diteruskan sebagai storedNetworkArray parameter.

  • Jika storedNetworkArray terlalu kecil untuk menampung semua jaringan Wi-Fi yang disimpan, fungsi ini mengisi array dan mengembalikan jumlah elemen array.

  • Jika kapabilitas WiFiConfig tidak ada, fungsi akan mengembalikan array kosong.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parameter

  • storedNetworkArray Penunjuk ke array yang mengembalikan jaringan Wi-Fi yang disimpan.

  • storedNetworkArrayCount Jumlah elemen storedNetworkArray dapat ditahan. Array harus memiliki satu elemen untuk setiap jaringan Wi-Fi yang disimpan.

Kesalahan

Mengembalikan -1 jika terjadi kesalahan dan diatur errno ke nilai kesalahan.

  • EACCES: manifes aplikasi tidak menyertakan kapabilitas WifiConfig.

  • EFAULT: storedNetworkArray parameternya adalah NULL.

  • ERANGE: storedNetworkArrayCount parameternya adalah 0.

  • EINVAL: storedNetworkArray parameter atau versi penyusunnya tidak valid.

  • EAGAIN: perangkat Wi-Fi belum siap.

Kesalahan lainnya errno mungkin juga ditentukan; kesalahan tersebut tidak deterministik dan perilaku yang sama mungkin tidak dipertahankan melalui pembaruan sistem.

Mengembalikan nilai

Mengembalikan jumlah elemen dalam array WifiConfig_StoredNetwork , atau -1 untuk kegagalan, dalam hal errno ini diatur ke nilai kesalahan.

Persyaratan manifes aplikasi

Manifes aplikasi harus menyertakan kapabilitas WifiConfig.