Networking_IpConfig_Apply-Funktion

  • Artikel

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 oder ipConfig 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.

Konzepte und Beispiele