Bagikan melalui

Fungsi Networking_IpConfig_ReleaseIp

  • Artikel

Header: #include <applibs/networking.h>

Melepaskan alamat IP dinamis perangkat.

Catatan

Memerlukan Azure Sphere OS versi 22.02 atau yang lebih baru.

int Networking_IpConfig_ReleaseIp(const char *networkInterfaceName);

Parameter

  • networkInterfaceName Penunjuk ke nama antarmuka jaringan untuk diperbarui.

Kesalahan

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

  • EACCES: aplikasi panggilan tidak memiliki kapabilitas NetworkConfig.

  • EFAULT: networkInterfaceName parameternya adalah NULL.

  • ENOENT: antarmuka jaringan tidak ada.

  • EPERM: alamat IP tidak dapat dirilis, seperti dalam konfigurasi IP statis.

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, -1 untuk kegagalan, dalam hal errno ini diatur ke nilai kesalahan.

Komentar

Jika IP telah diperoleh melalui DHCP, API ini secara sinkron mengirimkan pesan rilis DHCP, tetapi tidak ada jaminan bahwa itu diterima. API ini menghentikan protokol DHCP agar tidak mencoba memperoleh alamat IP hingga Networking_IpConfig_RenewIp dipanggil.

Manifes aplikasi harus menyertakan kapabilitas NetworkConfig.

Konsep dan sampel