Delen via


Networking_DhcpServer_Start functie

Header: #include <applibs/networking.h>

Registreert, configureert en start de DHCP-server voor een netwerkinterface. De configuratie die is opgegeven door deze functie-aanroep overschrijft de bestaande configuratie.

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

Parameters

  • networkInterfaceName De naam van de netwerkinterface die moet worden geconfigureerd.

  • dhcpServerConfig Een aanwijzer naar de Networking_DhcpServerConfig-struct die de configuratie van de DHCP-server vertegenwoordigt.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

  • EACCES: het toepassingsmanifest bevat niet de mogelijkheid DhcpService.

  • ENOENT: de networkInterfaceName parameter verwijst naar een interface die niet bestaat.

  • EPERM: deze bewerking is niet toegestaan op de netwerkinterface.

  • EFAULT: de networkInterfaceName parameter is NULL.

  • EFAULT: de dhcpServerConfig parameter is NULL.

  • EAGAIN: de netwerkstack is niet gereed.

  • EINVAL: de configuratie-struct heeft ongeldige parameters.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet bewaard via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno wordt ingesteld op de foutwaarde.

Opmerkingen

Als de netwerkinterface is ingeschakeld wanneer deze functie wordt aangeroepen, wordt de DHCP-server afgesloten, geconfigureerd en gestart. Als de interface offline is, wordt de server gestart wanneer de interface is ingeschakeld.

De interface moet worden geconfigureerd met een statisch IP-adres voordat deze functie wordt aangeroepen; anders wordt de EPERM-fout geretourneerd.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid DhcpService bevatten.

Concepten en voorbeelden