Dela via

funktionen Networking_IpConfig_RenewIp

  • Artikel

Sidhuvud: #include <applibs/networking.h>

Förnyar det dynamiska IP-adresskontraktet för enheten.

Observera

Kräver Azure Sphere OS version 22.02 eller senare.

int Networking_IpConfig_RenewIp(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 förnyas, 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 förnyar den här funktionen asynkront det aktuella IP-adresskontraktet. Den här funktionen gör ingenting om DHCP fortfarande arbetar med att hämta en IP-adress. Om DHCP-protokollet har stoppats med Networking_IpConfig_ReleaseIp startas DHCP-transaktionen igen. Använd Networking_IsNetworkingReady för att avgöra om den nya IP-adressen införskaffas.

Programmanifestet måste innehålla networkconfig-funktionen.

Koncept och exempel