Partager via


Networking_DhcpServer_Start, fonction

En-tête : #include <applibs/networking.h>

Inscrit, configure et démarre le serveur DHCP pour une interface réseau. La configuration spécifiée par cet appel de fonction remplace la configuration existante.

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

Paramètres

  • networkInterfaceName Nom de l’interface réseau à configurer.

  • dhcpServerConfig Pointeur vers le struct Networking_DhcpServerConfig qui représente la configuration du serveur DHCP.

Erreurs

Retourne -1 si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EACCES : le manifeste de l’application n’inclut pas la fonctionnalité DhcpService.

  • ENOENT : le networkInterfaceName paramètre fait référence à une interface qui n’existe pas.

  • EPERM : cette opération n’est pas autorisée sur l’interface réseau.

  • EFAULT : le networkInterfaceName paramètre est NULL.

  • EFAULT : le dhcpServerConfig paramètre est NULL.

  • EAGAIN : la pile réseau n’est pas prête.

  • EINVAL : le struct de configuration a des paramètres non valides.

Toutes les autres errno peuvent également être spécifiées ; ces erreurs ne sont pas déterministes et le même comportement peut ne pas être conservé par le biais des mises à jour système.

Valeur de retour

Retourne 0 en cas de réussite ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur.

Remarques

Si l’interface réseau est activée lorsque cette fonction est appelée, le serveur DHCP est arrêté, configuré et démarré. Si l’interface est arrêtée, le serveur démarre lorsque l’interface est activée.

L’interface doit être configurée avec une adresse IP statique avant que cette fonction soit appelée ; sinon, l’erreur EPERM est retournée.

Exigences du manifeste d’application

Le manifeste de l’application doit inclure la fonctionnalité DhcpService.

Concepts et exemples