Sdílet prostřednictvím

funkce Networking_IpConfig_RenewIp

  • Článek

Hlavička: #include <applibs/networking.h>

Obnoví zapůjčení dynamické IP adresy zařízení.

Poznámka

Vyžaduje operační systém Azure Sphere verze 22.02 nebo vyšší.

int Networking_IpConfig_RenewIp(const char *networkInterfaceName);

Parametry

  • networkInterfaceName Ukazatel na název síťového rozhraní, které chcete aktualizovat.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Volající aplikace nemá funkci NetworkConfig.

  • EFAULT: networkInterfaceName Parametr je NULL.

  • ENOENT: Síťové rozhraní neexistuje.

  • EPERM: IP adresu nelze obnovit, například v konfiguraci statické IP adresy.

Je také možné zadat všechny ostatní errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí hodnotu 0 pro úspěch, -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu.

Poznámky

Pokud byla IP adresa získána prostřednictvím protokolu DHCP, tato funkce asynchronně obnoví aktuální zapůjčení IP adresy. Tato funkce neprovede nic, pokud dhcp stále pracuje na získání IP adresy. Pokud byl protokol DHCP zastaven pomocí Networking_IpConfig_ReleaseIp, transakce DHCP se znovu spustí. Pomocí Networking_IsNetworkingReady zjistěte, jestli se nová IP adresa získá.

Manifest aplikace musí obsahovat funkci NetworkConfig.

Koncepty a ukázky