Share via

Funzione Networking_IpConfig_RenewIp

  • Articolo

Intestazione: #include <applicazioni/networking.h>

Rinnova il lease dinamico dell'indirizzo IP del dispositivo.

Nota

Richiede Azure Sphere OS versione 22.02 o successiva.

int Networking_IpConfig_RenewIp(const char *networkInterfaceName);

Parametri

  • networkInterfaceName Puntatore al nome dell'interfaccia di rete da aggiornare.

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EACCES: l'applicazione chiamante non dispone della funzionalità NetworkConfig.

  • EFAULT: il networkInterfaceName parametro è NULL.

  • ENOENT: l'interfaccia di rete non esiste.

  • EPERM: l'indirizzo IP non può essere rinnovato, ad esempio in una configurazione IP statica.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce 0 per operazione riuscita, -1 per errore, nel qual caso errno è impostato sul valore di errore.

Osservazioni

Se un indirizzo IP è stato acquisito tramite DHCP, questa funzione rinnova in modo asincrono il lease dell'indirizzo IP corrente. Questa funzione non esegue alcuna operazione se DHCP sta ancora lavorando per acquisire un indirizzo IP. Se il protocollo DHCP è stato arrestato con Networking_IpConfig_ReleaseIp, la transazione DHCP verrà avviata di nuovo. Utilizzare Networking_IsNetworkingReady per determinare se il nuovo IP viene acquisito.

Il manifesto dell'applicazione deve includere la funzionalità NetworkConfig.

Concetti ed esempi