Compartilhar via


Função Networking_IpConfig_Apply

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 ser configurada.

  • ipConfig Um ponteiro para o struct Networking_IpConfig que contém a configuração de IP a ser aplicada.

Erros

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

  • EACCES: o aplicativo de chamada não tem o recurso NetworkConfig.

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

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

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

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

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

Se as configurações de endereço IP sobrepostas estiverem presentes em um dispositivo, o comportamento dessa função será indefinido.

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso NetworkConfig.

Conceitos e exemplos