Dela via

funktionen Networking_IpConfig_ReleaseIp

  • Artikel

Sidhuvud: #include <applibs/networking.h>

Släpper enhetens dynamiska IP-adress.

Observera

Kräver Azure Sphere OS version 22.02 eller senare.

int Networking_IpConfig_ReleaseIp(const char *networkInterfaceName);

Parametrar

  • networkInterfaceName En pekare till namnet på nätverksgränssnittet som ska uppdateras.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: det anropande programmet har inte networkconfig-funktionen.

  • EFAULT: parametern networkInterfaceName är NULL.

  • ENOENT: nätverksgränssnittet finns inte.

  • EPERM: IP-adressen kan inte släppas, till exempel i en statisk IP-konfiguration.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar 0 för framgång, -1 för fel, i vilket fall errno är inställt på felvärdet.

Anmärkningar

Om en IP-adress har förvärvats via DHCP skickar det här API:et synkront ut DHCP-versionsmeddelandet, men det finns ingen garanti för att det tas emot. Det här API:t hindrar DHCP-protokollet från att försöka hämta en IP-adress tills Networking_IpConfig_RenewIp anropas.

Programmanifestet måste innehålla networkconfig-funktionen.

Koncept och exempel