Networking_IpConfig_ReleaseIp functie

Header: #include <applibs/networking.h>

Geeft het dynamische IP-adres van het apparaat vrij.

Opmerking

Vereist Azure Sphere OS versie 22.02 of hoger.

int Networking_IpConfig_ReleaseIp(const char *networkInterfaceName);

Parameters

• networkInterfaceName Een aanwijzer naar de naam van de netwerkinterface die moet worden bijgewerkt.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

• EACCES: de aanroepende toepassing heeft niet de mogelijkheid NetworkConfig.

• EFAULT: de networkInterfaceName parameter is NULL.

• ENOENT: de netwerkinterface bestaat niet.

• EPERM: het IP-adres kan niet worden vrijgegeven, zoals in een statische IP-configuratie.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet bewaard via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Opmerkingen

Als een IP is verkregen via DHCP, verzendt deze API synchroon het DHCP-releasebericht, maar er is geen garantie dat het wordt ontvangen. Deze API voorkomt dat het DHCP-protocol probeert een IP-adres te verkrijgen totdat Networking_IpConfig_RenewIp wordt aangeroepen.

Het toepassingsmanifest moet de mogelijkheid NetworkConfig bevatten.

Concepten en voorbeelden

• Voorbeeld: DHCP-client-app op hoog niveau