Partilhar via

Função Networking_IpConfig_RenewIp

  • Artigo

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

Renova a concessão do endereço IP dinâmico do dispositivo.

Nota

Requer a versão 22.02 ou superior do SO do Azure Sphere.

int Networking_IpConfig_RenewIp(const char *networkInterfaceName);

Parâmetros

  • networkInterfaceName Um ponteiro para o nome da interface de rede a atualizar.

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.

  • EFAULT: o networkInterfaceName parâmetro é NULL.

  • ENOENT: a interface de rede não existe.

  • EPERM: o endereço IP não pode ser renovado, como numa configuração de IP estático.

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, -1 para falha, caso errno em que está definido como o valor de erro.

Observações

Se um endereço IP tiver sido adquirido através de DHCP, esta função renova de forma assíncrona a concessão do endereço IP atual. Esta função não faz nada se o DHCP ainda estiver a trabalhar para adquirir um endereço IP. Se o protocolo DHCP tiver sido parado com Networking_IpConfig_ReleaseIp, a transação DHCP será reiniciada. Utilize Networking_IsNetworkingReady para determinar se o novo IP é adquirido.

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

Conceitos e exemplos