Compartilhar via

Função Networking_DhcpServer_Start

  • Artigo

Cabeçalho: #include <applibs/networking.h>

Registra, configura e inicia o servidor DHCP para uma interface de rede. A configuração especificada por essa chamada de função substitui a configuração existente.

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

Parâmetros

  • networkInterfaceName O nome da interface de rede a ser configurada.

  • dhcpServerConfig Um ponteiro para o struct Networking_DhcpServerConfig que representa a configuração do servidor DHCP.

Erros

Retorna -1 se um erro for encontrado e definir errno como o valor do erro.

  • EACCES: o manifesto do aplicativo não inclui o recurso DhcpService.

  • ENOENT: o networkInterfaceName parâmetro refere-se a uma interface que não existe.

  • EPERM: essa operação não é permitida na interface de rede.

  • EFAULT: o networkInterfaceName parâmetro é NULL.

  • EFAULT: o dhcpServerConfig parâmetro é NULL.

  • EAGAIN: a pilha de rede não está pronta.

  • EINVAL: o struct de configuração tem parâmetros inválidos.

Qualquer outro errno também pode ser especificado; esses erros não são determinísticos e o mesmo comportamento pode não ser mantido por meio de atualizações do sistema.

Valor retornado

Retorna 0 para êxito ou -1 para falha, nesse caso errno , será definido como o valor do erro.

Observações

Se a interface de rede estiver em funcionamento quando essa função for chamada, o servidor DHCP será desligado, configurado e iniciado. Se a interface estiver baixa, o servidor começará quando a interface estiver em cima.

A interface deve ser configurada com um endereço IP estático antes que essa função seja chamada; caso contrário, o erro EPERM é retornado.

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso DhcpService.

Conceitos e exemplos