Condividi tramite

Funzione Networking_IpConfig_Apply

  • Articolo

Intestazione: #include <applicazioni/networking.h>

Applica una configurazione IP a un'interfaccia di rete.

int Networking_IpConfig_Apply(const char *networkInterfaceName, const Networking_IpConfig *ipConfig);

Parametri

  • networkInterfaceName Nome dell'interfaccia di rete da configurare.

  • ipConfig Puntatore alla struttura Networking_IpConfig che contiene la configurazione IP da applicare.

Errori

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

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

  • ENOENT: il networkInterfaceName parametro fa riferimento a un'interfaccia che non esiste.

  • EPERM: questa operazione non è consentita nell'interfaccia di rete.

  • EFAULT: il networkInterfaceName parametro or ipConfig è NULL.

  • EAGAIN: lo stack di rete non è ancora pronto.

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 o -1 per errore, nel qual caso errno verrà impostato sul valore di errore.

Osservazioni

Questa funzione non verifica se l'indirizzo IP statico è compatibile con gli indirizzi IP dinamici ricevuti tramite un'interfaccia utilizzando un client DHCP.

Questa funzione non verifica se un server DHCP è disponibile in rete e se è configurato un indirizzo IP dinamico.

Se su un dispositivo sono presenti configurazioni di indirizzi IP sovrapposte, il comportamento di questa funzione non è definito.

Requisiti del manifesto dell'applicazione

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

Concetti ed esempi