Función Networking_DhcpServer_Start

Encabezado: #include <applibs/networking.h>

Registra, configura y inicia el servidor DHCP para una interfaz de red. La configuración especificada por esta llamada de función sobrescribe la configuración existente.

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

Parámetros

• networkInterfaceName El nombre de la interfaz de red que se va a configurar.

• dhcpServerConfig Puntero a la estructura de Networking_DhcpServerConfig que representa la configuración del servidor DHCP.

Errores

Devuelve -1 si se encuentra un error y se establece errno en el valor de error.

• EACCES: el manifiesto de la aplicación no incluye la función DhcpService.

• ENOENT: el networkInterfaceName parámetro se refiere a una interfaz que no existe.

• EPERM: esta operación no se permite en la interfaz de red.

• EFAULT: el networkInterfaceName parámetro es NULL.

• EFAULT: el dhcpServerConfig parámetro es NULL.

• EAGAIN: la pila de redes no está lista.

• EINVAL: la estructura de configuración tiene parámetros no válidos.

También se pueden especificar otros errno errores; estos errores no son deterministas y es posible que no se conserve el mismo comportamiento a través de las actualizaciones del sistema.

Valor devuelto

Devuelve 0 para éxito o -1 para error, en cuyo caso errno se establecerá en el valor de error.

Observaciones

Si la interfaz de red está para arriba cuando se llama a esta función, el servidor DHCP será apagado, configurado, e iniciado. Si la interfaz está abajo, el servidor se iniciará cuando la interfaz esté hacia arriba.

La interfaz se debe configurar con una dirección IP estática antes de llamar a esta función; De lo contrario, se devuelve el error EPERM.

Requisitos del manifiesto de la aplicación

El manifiesto de la aplicación debe incluir la funcionalidad DhcpService.

Conceptos y ejemplos

• Ejemplo: Servicios de red privada