Dela via


funktionen Networking_DhcpServer_Start

Sidhuvud: #include <applibs/networking.h>

Registrerar, konfigurerar och startar DHCP-servern för ett nätverksgränssnitt. Den konfiguration som anges av det här funktionsanropet skriver över den befintliga konfigurationen.

int Networking_DhcpServer_Start(const char *networkInterfaceName, const Networking_DhcpServerConfig *dhcpServerConfig);

Parametrar

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

  • dhcpServerConfig En pekare till den Networking_DhcpServerConfig struct som representerar DHCP-serverkonfigurationen.

Fel

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

  • EACCES: Programmanifestet innehåller inte DhcpService-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 networkInterfaceName är NULL.

  • EFAULT: parametern dhcpServerConfig är NULL.

  • EAGAIN: nätverksstacken är inte klar.

  • EINVAL: konfigurations struct har ogiltiga parametrar.

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

Om nätverksgränssnittet är aktiverat när den här funktionen anropas stängs DHCP-servern av, konfigureras och startas. Om gränssnittet är nere startar servern när gränssnittet är uppe.

Gränssnittet måste konfigureras med en statisk IP-adress innan den här funktionen anropas. annars returneras EPERM-felet.

Krav för programmanifest

Programmanifestet måste innehålla DhcpService-funktionen.

Koncept och exempel