Networking_IpConfig_Apply-Funktion
Header: #include <applibs/networking.h>
Wendet eine IP-Konfiguration auf eine Netzwerkschnittstelle an.
int Networking_IpConfig_Apply(const char *networkInterfaceName, const Networking_IpConfig *ipConfig);
Parameter
networkInterfaceName
Der Name der zu konfigurierenden Netzwerkschnittstelle.ipConfig
Ein Zeiger auf die Networking_IpConfig Struktur, die die anzuwendende IP-Konfiguration enthält.
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.
ENOENT: Der
networkInterfaceName
Parameter bezieht sich auf eine Schnittstelle, die nicht vorhanden ist.EPERM: Dieser Vorgang ist auf der Netzwerkschnittstelle nicht zulässig.
EFAULT: Der
networkInterfaceName
Parameter oderipConfig
ist NULL.EAGAIN: Der Netzwerkstapel ist noch nicht bereit.
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 oder -1 für Fehler zurück. In diesem Fall errno
wird auf den Fehlerwert festgelegt.
Bemerkungen
Diese Funktion überprüft nicht, ob die statische IP-Adresse mit den dynamischen IP-Adressen kompatibel ist, die über eine Schnittstelle über einen DHCP-Client empfangen werden.
Diese Funktion überprüft nicht, ob ein DHCP-Server im Netzwerk verfügbar ist und ob eine dynamische IP-Adresse konfiguriert ist.
Wenn sich überlappende IP-Adresskonfigurationen auf einem Gerät vorhanden sind, ist das Verhalten dieser Funktion nicht definiert.
Anforderungen an das Anwendungsmanifest
Das Anwendungsmanifest muss die NetworkConfig-Funktion enthalten.