Freigeben über

Networking_IpConfig_ReleaseIp-Funktion

  • Artikel

Header: #include <applibs/networking.h>

Gibt die dynamische IP-Adresse des Geräts frei.

Hinweis

Erfordert die Azure Sphere-Betriebssystemversion 22.02 oder höher.

int Networking_IpConfig_ReleaseIp(const char *networkInterfaceName);

Parameter

  • networkInterfaceName Ein Zeiger auf den Namen der zu aktualisierenden Netzwerkschnittstelle.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

  • EACCES: Die aufrufende Anwendung verfügt nicht über die NetworkConfig-Funktion.

  • EFAULT: Der networkInterfaceName Parameter ist NULL.

  • ENOENT: Die Netzwerkschnittstelle ist nicht vorhanden.

  • EPERM: Die IP-Adresse kann nicht freigegeben werden, z. B. in einer statischen IP-Konfiguration.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.

Rückgabewert

Gibt 0 für erfolg, -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Bemerkungen

Wenn eine IP-Adresse über DHCP abgerufen wurde, sendet diese API die DHCP-Releasenachricht synchron, aber es gibt keine Garantie, dass sie empfangen wird. Diese API verhindert, dass das DHCP-Protokoll versucht, eine IP-Adresse zu erhalten, bis Networking_IpConfig_RenewIp aufgerufen wird.

Das Anwendungsmanifest muss die NetworkConfig-Funktion enthalten.

Konzepte und Beispiele