Partager via

Networking_IpConfig_Apply, fonction

  • Article

En-tête : #include <applibs/networking.h>

Applique une configuration IP à une interface réseau.

int Networking_IpConfig_Apply(const char *networkInterfaceName, const Networking_IpConfig *ipConfig);

Paramètres

  • networkInterfaceName Nom de l’interface réseau à configurer.

  • ipConfig Pointeur vers le struct Networking_IpConfig qui contient la configuration IP à appliquer.

Erreurs

Retourne -1 si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EACCES : l’application appelante n’a pas la fonctionnalité NetworkConfig.

  • ENOENT : le networkInterfaceName paramètre fait référence à une interface qui n’existe pas.

  • EPERM : cette opération n’est pas autorisée sur l’interface réseau.

  • EFAULT : le networkInterfaceName paramètre ou ipConfig est NULL.

  • EAGAIN : la pile réseau n’est pas encore prête.

Toutes les autres errno peuvent également être spécifiées ; ces erreurs ne sont pas déterministes et le même comportement peut ne pas être conservé par le biais des mises à jour système.

Valeur de retour

Retourne 0 en cas de réussite ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur.

Remarques

Cette fonction ne vérifie pas si l’adresse IP statique est compatible avec les adresses IP dynamiques reçues via une interface utilisant un client DHCP.

Cette fonction ne vérifie pas si un serveur DHCP est disponible sur le réseau et si une adresse IP dynamique est configurée.

Si des configurations d’adresses IP qui se chevauchent sont présentes sur un appareil, le comportement de cette fonction n’est pas défini.

Exigences du manifeste d’application

Le manifeste de l’application doit inclure la fonctionnalité NetworkConfig.

Concepts et exemples