Udostępnij za pośrednictwem

Funkcja Networking_IpConfig_ReleaseIp

  • Artykuł

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

Zwalnia dynamiczny adres IP urządzenia.

Uwaga

Wymaga systemu operacyjnego Azure Sphere w wersji 22.02 lub nowszej.

int Networking_IpConfig_ReleaseIp(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 zwolnić 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, ten interfejs API automatycznie wysyła komunikat o wersji DHCP, ale nie ma gwarancji, że zostanie odebrany. Ten interfejs API zatrzymuje próbę uzyskania adresu IP protokołu DHCP do momentu wywołania Networking_IpConfig_RenewIp .

Manifest aplikacji musi zawierać funkcję NetworkConfig.

Pojęcia i próbki