Networking_DhcpServer_Start 函数

标头: #include <applibs/networking.h>

注册、配置和启动网络接口的 DHCP 服务器。 此函数调用指定的配置将覆盖现有配置。

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

参数

  • networkInterfaceName 要配置的网络接口的名称。

  • dhcpServerConfig 指向表示 DHCP 服务器配置的 Networking_DhcpServerConfig 结构的指针。

错误

如果遇到错误并设置为 errno 错误值,则返回 -1。

  • EACCES:应用程序清单不包括 DhcpService 功能。

  • ENOENT: networkInterfaceName 参数引用不存在的接口。

  • EPERM:网络接口上不允许此操作。

  • EFAULT: networkInterfaceName 参数为 NULL。

  • EFAULT: dhcpServerConfig 参数为 NULL。

  • EAGAIN:网络堆栈未准备就绪。

  • EINVAL:配置结构的参数无效。

还可以指定任何其他 errno 错误;此类错误不是确定性的,并且可能不会通过系统更新保留相同的行为。

返回值

如果成功,则返回 0,如果失败,则返回 -1,在这种情况下 errno ,将设置为错误值。

言论

如果调用此函数时网络接口处于打开状态,DHCP 服务器将关闭、配置并启动。 如果接口关闭,则服务器将在接口打开时启动。

在调用此函数之前,必须使用静态 IP 地址配置接口;否则,将返回 EPERM 错误。

应用程序清单要求

应用程序清单必须包含 DhcpService 功能。

概念和示例