Поделиться через

Функция Networking_DhcpServer_Start

  • Статья

Заголовок: #include <applibs/networking.h>

Регистрирует, настраивает и запускает DHCP-сервер для сетевого интерфейса. Конфигурация, указанная этим вызовом функции, перезаписывает существующую конфигурацию.

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

Параметры

  • networkInterfaceName Имя настраиваемого сетевого интерфейса.

  • dhcpServerConfig Указатель на структуру Networking_DhcpServerConfig , представляющую конфигурацию DHCP-сервера.

Ошибки

Возвращает значение -1 при обнаружении ошибки и задает errno значение ошибки.

  • EACCES: манифест приложения не включает возможность DhcpService.

  • ENOENT: networkInterfaceName параметр ссылается на интерфейс, который не существует.

  • EPERM: эта операция запрещена в сетевом интерфейсе.

  • EFAULT: networkInterfaceName параметр имеет значение NULL.

  • EFAULT: dhcpServerConfig параметр имеет значение NULL.

  • EAGAIN: сетевой стек не готов.

  • EINVAL: в структуре конфигурации есть недопустимые параметры.

Можно также указать любой другой errno . Такие ошибки не являются детерминированными, и такое же поведение может не сохраняться при обновлении системы.

Возвращаемое значение

Возвращает значение 0 для успешного выполнения или -1 для сбоя. В этом случае errno будет задано значение ошибки.

Замечания

Если сетевой интерфейс работает при вызове этой функции, DHCP-сервер будет выключен, настроен и запущен. Если интерфейс не работает, сервер запустится при его запуске.

Интерфейс должен быть настроен со статическим IP-адресом перед вызовом этой функции; В противном случае возвращается ошибка EPERM.

Требования к манифесту приложения

Манифест приложения должен содержать возможность DhcpService.

Основные понятия и примеры