Sdílet prostřednictvím

Networking_IpConfig_ReleaseIp funkce

  • Článek

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

Uvolní dynamickou IP adresu zařízení.

Poznámka

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

int Networking_IpConfig_ReleaseIp(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 uvolnit, 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, toto rozhraní API synchronně odesílá zprávu o vydání DHCP, ale neexistuje žádná záruka, že bude přijata. Toto rozhraní API zabrání protokolu DHCP v pokusu o získání IP adresy, dokud se nezavolá Networking_IpConfig_RenewIp .

Manifest aplikace musí obsahovat funkci NetworkConfig.

Koncepty a ukázky