Networking_IpConfig_ReleaseIp-Funktion
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.