Partilhar via

Função Networking_IpConfig_ReleaseIp

  • Artigo

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

Liberta o endereço IP dinâmico do dispositivo.

Nota

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

int Networking_IpConfig_ReleaseIp(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: não é possível libertar o endereço IP, 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 IP tiver sido adquirido através de DHCP, esta API envia de forma síncrona a mensagem de versão dhCP, mas não há garantias de que seja recebida. Esta API impede que o protocolo DHCP tente adquirir um endereço IP até que Networking_IpConfig_RenewIp seja chamado.

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

Conceitos e exemplos