Funzione Networking_IpConfig_ApplyNetworking_IpConfig_Apply Function

Intestazione: #include <applibs/networking.h>Header: #include <applibs/networking.h>

Applica una configurazione IP a un'interfaccia di rete.Applies an IP configuration to a network interface.

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

ParametriParameters

  • networkInterfaceName Nome dell'interfaccia di rete da configurare.networkInterfaceName The name of the network interface to configure.

  • ipConfig Puntatore allo struct Networking_IpConfig che contiene la configurazione IP da applicare.ipConfig A pointer to the Networking_IpConfig struct that contains the IP configuration to apply.

ErrorsErrors

Restituisce-1 se viene rilevato un errore e imposta sul errno valore di errore.Returns -1 if an error is encountered and sets errno to the error value.

  • EACCES: l'applicazione chiamante non ha la funzionalità NetworkConfig.EACCES: the calling application doesn't have the NetworkConfig capability.

  • ENOENT: il parametro networkInterfaceName fa riferimento a un'interfaccia che non esiste.ENOENT: the networkInterfaceName parameter refers to an interface that does not exist.

  • EPERM: questa operazione non è consentita per l'interfaccia di rete.EPERM: this operation is not allowed on the network interface.

  • EFAULT: il parametro networkInterfaceName o ipConfig è NULL.EFAULT: the networkInterfaceName or ipConfig parameter is NULL.

  • EAGAIN: lo stack di rete non è ancora pronto.EAGAIN: the networking stack isn't ready yet.

errnoÈ possibile specificare anche qualsiasi altro tipo di errore. tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti del sistema.Any other errno may also be specified; such errors aren't deterministic and the same behavior might not be retained through system updates.

Valore restituitoReturn value

Restituisce 0 per l'esito positivo o-1 per l'esito negativo, nel qual caso errno verrà impostato sul valore di errore.Returns 0 for success, or -1 for failure, in which case errno will be set to the error value.

OsservazioniRemarks

Questa funzione non verifica se l'indirizzo IP statico è compatibile con gli indirizzi IP dinamici ricevuti tramite un'interfaccia con un client DHCP.This function does not verify whether the static IP address is compatible with the dynamic IP addresses received through an interface using a DHCP client.

Questa funzione non verifica se un server DHCP è disponibile in rete e se è configurato un indirizzo IP dinamico.This function does not verify whether a DHCP server is available on the network and if a dynamic IP address is configured.

In presenza di configurazioni di indirizzi IP sovrapposte in un dispositivo, il comportamento di questa funzione non è definito.If overlapping IP address configurations are present on a device, the behavior of this function is undefined.

Requisiti del manifesto dell'applicazioneApplication manifest requirements

Il manifesto dell'applicazione deve includere la funzionalità NetworkConfig.The application manifest must include the NetworkConfig capability.

Concetti ed esempiConcepts and samples