Partager via

Networking_IpConfig_ReleaseIp, fonction

  • Article

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

Libère l’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_ReleaseIp(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 libéré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 API envoie de façon synchrone le message de publication DHCP, mais il n’existe aucune garantie qu’elle soit reçue. Cette API empêche le protocole DHCP de tenter d’acquérir une adresse IP jusqu’à ce qu’Networking_IpConfig_RenewIp soit appelé.

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

Concepts et exemples