Bagikan melalui

Fungsi WifiConfig_SetConfigName

  • Artikel

Header: #include <applibs/wificonfig.h>

Mengatur nama untuk konfigurasi jaringan. Nama dapat digunakan sebagai gagang yang mudah untuk mengidentifikasi konfigurasi jaringan. Sangat disarankan agar nama ini unik.

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_SetConfigName(int networkId, const char *configName);

Parameter

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

  • configname Penunjuk ke array byte yang berisi nama konfigurasi. Array byte harus berupa NULL diakhiri dan kurang dari atau sama dengan WIFICONFIG_CONFIG_NAME_MAX_LENGTH byte (tidak termasuk penghentian).

Kesalahan

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

  • EACCES: manifes aplikasi tidak menyertakan kapabilitas WifiConfig.

  • EFAULT: configName parameternya adalah NULL.

  • ERANGE: configName parameter lebih besar dari WIFICONFIG_CONFIG_NAME_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.