Bagikan melalui

Fungsi WifiConfig_SetSSID

  • Artikel

Header: #include <applibs/wificonfig.h>

Mengatur SSID untuk jaringan Wi-Fi.

Pengaturan ini langsung efektif tetapi tidak akan tetap ada di seluruh perangkat melakukan boot ulang kecuali fungsi WifiConfig_PersistConfig dipanggil setelah fungsi ini.

static int WifiConfig_SetSSID(int networkId, const uint8_t *ssid, size_t ssidLength);

Parameter

  • networkId ID jaringan yang akan dikonfigurasi. WifiConfig_AddNetwork mengembalikan ID jaringan.

  • ssid Penunjuk ke array byte yang berisi SSID baru. Pengodean karakter tidak ditentukan.

  • ssidLength Jumlah byte dalam ssid parameter. Harus kurang dari atau sama dengan WIFICONFIG_SSID_MAX_LENGTH.

Kesalahan

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

  • EACCES: manifes aplikasi tidak menyertakan kapabilitas WifiConfig.

  • EFAULT: ssid parameternya adalah NULL.

  • ERANGE: ssidLength parameter lebih besar dari WIFICONFIG_SSID_MAX_LENGTH.

  • EAGAIN: perangkat Wi-Fi belum siap.

  • ENETDOWN: antarmuka jaringan Wi-Fi tidak tersedia.

  • EINVAL: networkId parameter tidak valid.

  • ENODEV: networkId parameter tidak cocok dengan ID jaringan yang disimpan.

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

Mengembalikan nilai

Mengembalikan 0 untuk keberhasilan, atau -1 untuk kegagalan, dalam hal errno ini diatur ke nilai kesalahan.

Persyaratan manifes aplikasi

Manifes aplikasi harus menyertakan kapabilitas WifiConfig.