Condividi tramite

Funzione Networking_DhcpServer_Start

  • Articolo

Intestazione: #include <applicazioni/networking.h>

Registra, configura e avvia il server DHCP per un'interfaccia di rete. La configurazione specificata da questa chiamata di funzione sovrascrive la configurazione esistente.

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

Parametri

  • networkInterfaceName Nome dell'interfaccia di rete da configurare.

  • dhcpServerConfig Puntatore alla struttura Networking_DhcpServerConfig che rappresenta la configurazione del server DHCP.

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EACCES: il manifesto dell'applicazione non include la funzionalità DhcpService.

  • ENOENT: il networkInterfaceName parametro fa riferimento a un'interfaccia che non esiste.

  • EPERM: questa operazione non è consentita nell'interfaccia di rete.

  • EFAULT: il networkInterfaceName parametro è NULL.

  • EFAULT: il dhcpServerConfig parametro è NULL.

  • EAGAIN: lo stack di rete non è pronto.

  • EINVAL: la struttura di configurazione ha parametri non validi.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce 0 per operazione riuscita o -1 per errore, nel qual caso errno verrà impostato sul valore di errore.

Osservazioni

Se l'interfaccia di rete è attiva quando viene chiamata questa funzione, il server DHCP verrà arrestato, configurato e avviato. Se l'interfaccia è in giù, il server verrà avviato quando l'interfaccia è su.

L'interfaccia deve essere configurata con un indirizzo IP statico prima che questa funzione venga chiamata; in caso contrario, viene restituito l'errore EPERM.

Requisiti del manifesto dell'applicazione

Il manifesto dell'applicazione deve includere la funzionalità DhcpService.

Concetti ed esempi