Funzione Networking_SetStaticIpNetworking_SetStaticIp Function

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

Importante

questa funzione è obsoleta.This function is obsolete. Per configurare un indirizzo IP statico, usare Networking_IpConfig_EnableStaticIp su uno struct Networking_IpConfig inizializzato, quindi applicarlo con Networking_IpConfig_Apply.To configure a static IP address, use Networking_IpConfig_EnableStaticIp on an initialized Networking_IpConfig struct, then apply it with Networking_IpConfig_Apply.

Imposta la configurazione IP statica per un'interfaccia di rete.Sets the static IP configuration for a network interface.

Nota

Questa funzione non verifica se l'indirizzo IP statico è compatibile con gli indirizzi IP dinamici assegnati a un'interfaccia da un client DHCP.This function doesn't verify whether the static IP address is compatible with dynamic IP addresses that are assigned to an interface by a DHCP client. In presenza di configurazioni di indirizzi IP sovrapposte in un dispositivo, il comportamento non è garantito.If overlapping IP address configurations are present on a device, the behavior is not guaranteed.

int Networking_SetStaticIp(const char *networkInterfaceName, const Networking_StaticIpConfiguration *staticIpConfiguration);

ParametriParameters

  • networkInterfaceName Stringa che contiene il nome dell'interfaccia di rete da configurare.networkInterfaceName A string that contains the name of the network interface to configure.

  • staticIpConfiguration Puntatore allo struct Networking_StaticIpConfiguration che contiene la configurazione di IP statico.staticIpConfiguration A pointer to the Networking_StaticIpConfiguration struct that contains the static IP configuration.

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: il manifesto dell'applicazione non include la funzionalità NetworkConfig.EACCES: the application manifest does not include the NetworkConfig capability.

  • ENOENT: l'interfaccia di rete non esiste.ENOENT: the network interface 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 staticIpConfiguration è NULL.EFAULT: the staticIpConfiguration 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,-1 per l'errore, nel qual caso errno viene impostato sul valore di errore.Returns 0 for success, -1 for failure, in which case errno is set to the error value.