Condividi tramite

Funzione Networking_IpConfig_ReleaseIp

  • Articolo

Intestazione: #include <applicazioni/networking.h>

Rilascia l'indirizzo IP dinamico del dispositivo.

Nota

Richiede Azure Sphere OS versione 22.02 o successiva.

int Networking_IpConfig_ReleaseIp(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 rilasciato, 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 IP è stato acquisito tramite DHCP, questa API invia in modo sincrono il messaggio di rilascio DHCP, ma non vi è alcuna garanzia che venga ricevuto. Questa API impedisce al protocollo DHCP di tentare di acquisire un indirizzo IP fino a quando non viene chiamato Networking_IpConfig_RenewIp .

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

Concetti ed esempi