Partilhar via

Função Networking_IpConfig_Apply

  • Artigo

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

Aplica uma configuração de IP a uma interface de rede.

int Networking_IpConfig_Apply(const char *networkInterfaceName, const Networking_IpConfig *ipConfig);

Parâmetros

  • networkInterfaceName O nome da interface de rede a configurar.

  • ipConfig Um ponteiro para a estrutura Networking_IpConfig que contém a configuração de IP a aplicar.

Erros

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

  • EACCES: a aplicação de chamada não tem a capacidade NetworkConfig.

  • 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 ou ipConfig é NULL.

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

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

Esta função não verifica se o endereço IP estático é compatível com os endereços IP dinâmicos recebidos através de uma interface com um cliente DHCP.

Esta função não verifica se um servidor DHCP está disponível na rede e se está configurado um endereço IP dinâmico.

Se estiverem presentes configurações de endereços IP sobrepostas num dispositivo, o comportamento desta função é indefinido.

Requisitos do manifesto de aplicação

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

Conceitos e exemplos