Udostępnij za pośrednictwem

Funkcja Networking_IpConfig_RenewIp

  • Artykuł

Nagłówek: #include <applibs/networking.h>

Odnawia dzierżawę dynamicznych adresów IP urządzenia.

Uwaga

Wymaga systemu operacyjnego Azure Sphere w wersji 22.02 lub nowszej.

int Networking_IpConfig_RenewIp(const char *networkInterfaceName);

Parametry

  • networkInterfaceName Wskaźnik do nazwy interfejsu sieciowego do zaktualizowania.

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EACCES: aplikacja wywołująca nie ma funkcji NetworkConfig.

  • EFAULT: networkInterfaceName parametr ma wartość NULL.

  • ENOENT: interfejs sieci nie istnieje.

  • EPERM: nie można odnowić adresu IP, na przykład w konfiguracji statycznej adresu IP.

Mogą być również określone inne errno błędy; takie błędy nie są deterministyczne i to samo zachowanie może nie być zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca wartość 0 dla powodzenia, -1 dla niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu.

Uwagi

Jeśli adres IP został nabyty za pośrednictwem protokołu DHCP, ta funkcja asynchronicznego odnawia bieżącą dzierżawę adresu IP. Ta funkcja nie działa, jeśli protokół DHCP nadal pracuje nad uzyskaniem adresu IP. Jeśli protokół DHCP został zatrzymany z Networking_IpConfig_ReleaseIp, transakcja DHCP zostanie uruchomiona ponownie. Użyj Networking_IsNetworkingReady , aby ustalić, czy nowy adres IP zostanie nabyty.

Manifest aplikacji musi zawierać funkcję NetworkConfig.

Pojęcia i próbki