Compartir vía

Función Networking_IpConfig_ReleaseIp

  • Artículo

Encabezado: #include <applibs/networking.h>

Libera la dirección IP dinámica del dispositivo.

Nota

Requiere Azure Sphere OS versión 22.02 o posterior.

int Networking_IpConfig_ReleaseIp(const char *networkInterfaceName);

Parámetros

  • networkInterfaceName Un puntero al nombre de la interfaz de red para actualizar.

Errores

Devuelve -1 si se encuentra un error y se establece errno en el valor de error.

  • EACCES: la aplicación de llamadas no tiene la capacidad NetworkConfig.

  • EFAULT: el networkInterfaceName parámetro es NULL.

  • ENOENT: la interfaz de red no existe.

  • EPERM: la dirección IP no se puede liberar, como en una configuración de IP estática.

También se pueden especificar otros errno errores; estos errores no son deterministas y es posible que no se conserve el mismo comportamiento a través de las actualizaciones del sistema.

Valor devuelto

Devuelve 0 para éxito, -1 para error, en cuyo caso errno se establece en el valor de error.

Observaciones

Si un IP se había adquirido a través de DHCP, esta API envía sincrónicamente el mensaje de la versión DHCP, pero no hay ninguna garantía de que se recibe. Esta API hace que el protocolo DHCP deje de intentar adquirir una dirección IP hasta que se llame a Networking_IpConfig_RenewIp .

El manifiesto de la aplicación debe incluir la funcionalidad NetworkConfig.

Conceptos y ejemplos