Compartilhar via

Função Networking_IpConfig_RenewIp

  • Artigo

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

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

Nota

Requer o sistema operacional do Azure Sphere versão 22.02 ou superior.

int Networking_IpConfig_RenewIp(const char *networkInterfaceName);

Parâmetros

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

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.

  • 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 em uma configuração de IP estática.

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, -1 para falha, nesse caso errno é definido como o valor do erro.

Observações

Se um endereço IP foi adquirido via DHCP, essa função renovará assíncronamente a concessão de endereço IP atual. Essa função não fará nada se o DHCP ainda estiver trabalhando para adquirir um endereço IP. Se o protocolo DHCP tiver sido interrompido com Networking_IpConfig_ReleaseIp, a transação DHCP será reiniciada. Use Networking_IsNetworkingReady para determinar se o novo IP foi adquirido.

O manifesto do aplicativo deve incluir o recurso NetworkConfig.

Conceitos e exemplos