Compartir vía

Función Networking_IpConfig_RenewIp

  • Artículo

Encabezado: #include <applibs/networking.h>

Renueva la concesión dinámica de direcciones IP del dispositivo.

Nota

Requiere Azure Sphere OS versión 22.02 o posterior.

int Networking_IpConfig_RenewIp(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 renovar, 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 una dirección IP se adquirió a través de DHCP, esta función renueva asincrónicamente la concesión de la dirección IP actual. Esta función no hace nada si DHCP todavía está trabajando para adquirir una dirección IP. Si el protocolo DHCP se ha detenido con Networking_IpConfig_ReleaseIp, se volverá a iniciar la transacción DHCP. Use Networking_IsNetworkingReady para determinar si se adquiere la nueva IP.

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

Conceptos y ejemplos