Udostępnij za pośrednictwem

Funkcja Networking_DhcpServer_Start

  • Artykuł

Nagłówek: #include <applibs/networking.h>

Rejestruje, konfiguruje i uruchamia serwer DHCP interfejsu sieciowego. Konfiguracja określona przez to wywołanie funkcji zastępuje istniejącą konfigurację.

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

Parametry

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EACCES: manifest aplikacji nie zawiera funkcji DhcpService.

  • ENOENT: networkInterfaceName parametr odwołuje się do interfejsu, który nie istnieje.

  • EPERM: ta operacja nie jest dozwolona w interfejsie sieciowym.

  • EFAULT: networkInterfaceName parametr ma wartość NULL.

  • EFAULT: dhcpServerConfig parametr ma wartość NULL.

  • EAGAIN: stos sieci nie jest gotowy.

  • EINVAL: struktura konfiguracji ma nieprawidłowe parametry.

Mogą być również określone inne errno błędy; takie błędy nie są deterministyczne i to samo zachowanie może nie być zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca wartość 0 dla sukcesu lub -1 dla niepowodzenia, w którym to przypadku errno zostanie ustawiona wartość błędu.

Uwagi

Jeśli po wywołaniu tej funkcji interfejs sieci jest w górze, serwer DHCP zostanie zamknięty, skonfigurowany i uruchomiony. Jeśli interfejs jest w dół, serwer uruchomi się, gdy interfejs jest w górę.

Interfejs musi być skonfigurowany ze statycznym adresem IP, zanim ta funkcja zostanie wywołana; w przeciwnym razie zostanie zwrócony błąd EPERM.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję DhcpService.

Pojęcia i próbki