Partilhar via

Função Networking_SetInterfaceState

  • Artigo

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

Ativa ou desativa uma interface de rede.

int Networking_SetInterfaceState(const char *networkInterfaceName, bool isEnabled);

Parâmetros

  • networkInterfaceName O nome da interface de rede a atualizar.

  • isEnabled true para ativar a interface, falso para desativá-la.

Erros

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

  • EACCES: o manifesto da aplicação não inclui a capacidade NetworkConfig.

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

  • EPERM: esta função não é permitida na interface.

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

  • EIO: a interface está inacessível.

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 está definido como o valor de erro.

Requisitos do manifesto de aplicação

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

Conceitos e exemplos

Nota

Se Wi-Fi estiver desativado através de Networking_SetInterfaceState o subsistema Wi-Fi estará no modo de "suspensão leve". Isto também deve encerrar as emissões de RF. No entanto, se tiver de limitar as emissões devido à conformidade ou certificações, certifique-se de que testa e executa as suas próprias medições.

Nos designs em que não é necessário Wi-Fi, os componentes de front-end RF podem ser excluídos da estrutura de hardware. Para obter mais informações, veja Desativar Wi-Fi front-end RF no MT3620.