Dela via


funktionen Networking_IpConfig_Apply

Sidhuvud: #include <applibs/networking.h>

Tillämpar en IP-konfiguration på ett nätverksgränssnitt.

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

Parametrar

  • networkInterfaceName Namnet på nätverksgränssnittet som ska konfigureras.

  • ipConfig En pekare till den Networking_IpConfig struct som innehåller IP-konfigurationen som ska användas.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: det anropande programmet har inte networkconfig-funktionen.

  • ENOENT: parametern networkInterfaceName refererar till ett gränssnitt som inte finns.

  • EPERM: den här åtgärden är inte tillåten i nätverksgränssnittet.

  • EFAULT: parametern eller ipConfig parametern networkInterfaceName är NULL.

  • EAGAIN: nätverksstacken är inte klar än.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar 0 för lyckat resultat, eller -1 för fel, i vilket fall errno felvärdet anges.

Anmärkningar

Den här funktionen verifierar inte om den statiska IP-adressen är kompatibel med de dynamiska IP-adresser som tas emot via ett gränssnitt med hjälp av en DHCP-klient.

Den här funktionen verifierar inte om en DHCP-server är tillgänglig i nätverket och om en dynamisk IP-adress har konfigurerats.

Om det finns överlappande IP-adresskonfigurationer på en enhet är funktionens beteende odefinierat.

Krav för programmanifest

Programmanifestet måste innehålla networkconfig-funktionen.

Koncept och exempel