Partager via

Networking_IpConfig_RenewIp, fonction

  • Article

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

Renouvelle le bail d’adresse IP dynamique de l’appareil.

Note

Nécessite le système d’exploitation Azure Sphere version 22.02 ou ultérieure.

int Networking_IpConfig_RenewIp(const char *networkInterfaceName);

Paramètres

  • networkInterfaceName Pointeur vers le nom de l’interface réseau à mettre à jour.

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.

  • EFAULT : le networkInterfaceName paramètre est NULL.

  • ENOENT : l’interface réseau n’existe pas.

  • EPERM : l’adresse IP ne peut pas être renouvelée, par exemple dans une configuration IP statique.

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 pour la réussite, -1 pour l’échec, auquel cas errno est défini sur la valeur d’erreur.

Remarques

Si une adresse IP a été acquise via DHCP, cette fonction renouvelle de façon asynchrone le bail d’adresse IP actuel. Cette fonction ne fait rien si DHCP travaille toujours à l’acquisition d’une adresse IP. Si le protocole DHCP a été arrêté avec Networking_IpConfig_ReleaseIp, la transaction DHCP est redémarré. Utilisez Networking_IsNetworkingReady pour déterminer si la nouvelle adresse IP est acquise.

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

Concepts et exemples