Bagikan melalui

Fungsi Networking_SetInterfaceState

  • Artikel

Header: #include <applibs/networking.h>

Mengaktifkan atau menonaktifkan antarmuka jaringan.

int Networking_SetInterfaceState(const char *networkInterfaceName, bool isEnabled);

Parameter

  • networkInterfaceName Nama antarmuka jaringan untuk diperbarui.

  • isEnabled true untuk mengaktifkan antarmuka, false untuk menonaktifkannya.

Kesalahan

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

  • EACCES: manifes aplikasi tidak menyertakan kapabilitas NetworkConfig.

  • ENOENT: antarmuka jaringan tidak ada.

  • EPERM: fungsi ini tidak diperbolehkan pada antarmuka.

  • EAGAIN: tumpukan jaringan belum siap.

  • EIO: antarmuka tidak dapat diakses.

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 NetworkConfig.

Konsep dan sampel

Catatan

Jika Wi-Fi dinonaktifkan melalui Networking_SetInterfaceState subsstem Wi-Fi akan berada dalam mode "tidur ringan". Ini juga harus mematikan emisi RF. Namun, jika Anda diharuskan membatasi emisi karena kepatuhan atau sertifikasi, pastikan Anda menguji dan melakukan pengukuran Anda sendiri.

Dalam desain di mana Wi-Fi tidak diperlukan, komponen ujung depan RF dapat dikecualikan dari desain perangkat keras. Untuk informasi selengkapnya, lihat Menonaktifkan Wi-Fi ujung depan RF di MT3620.