Partilhar via

Função Networking_DhcpServer_Start

  • Artigo

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

Regista, configura e inicia o servidor DHCP para uma interface de rede. A configuração especificada por esta 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 configurar.

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

Erros

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

  • EACCES: o manifesto da aplicação não inclui a capacidade DhcpService.

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

  • EPERM: esta 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: a estrutura de configuração tem parâmetros inválidos.

Também pode ser especificado qualquer outro errno ; esses erros não são deterministas e o mesmo comportamento pode não ser retido através de atualizações do sistema.

Valor devolvido

Devolve 0 para êxito ou -1 para falha, caso errno em que será definido como o valor de erro.

Observações

Se a interface de rede estiver ativada quando esta função for chamada, o servidor DHCP será encerrado, configurado e iniciado. Se a interface estiver inativa, o servidor será iniciado quando a interface estiver ativada.

A interface tem de ser configurada com um endereço IP estático antes de esta função ser chamada; caso contrário, é devolvido o erro EPERM.

Requisitos do manifesto de aplicação

O manifesto da aplicação tem de incluir a capacidade DhcpService.

Conceitos e exemplos