Partilhar via


Função WifiConfig_SetNetworkEnabled

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

Ativa ou desativa uma configuração de rede Wi-Fi.

A configuração entra em vigor imediatamente, mas não persistirá nas reinicializações do dispositivo, a menos que a função WifiConfig_PersistConfig seja chamada após essa função.

static int WifiConfig_SetNetworkEnabled(int networkId, bool enabled);

Parâmetros

  • networkId O ID da rede a ser configurada. WifiConfig_AddNetwork retorna a ID de rede.

  • enabledtrue para habilitar a rede; caso contrário, false.

Erros

Retorna -1 se um erro for encontrado e define errno como o valor de erro.

  • EACCES: o manifesto do aplicativo não inclui o recurso WifiConfig.

  • EAGAIN: o dispositivo Wi-Fi não está pronto.

  • ENETDOWN: a interface de rede Wi-Fi não está disponível.

  • EINVAL: o networkId parâmetro é inválido.

  • ENODEV: o networkId parâmetro não corresponde a nenhum dos IDs das redes armazenadas.

Qualquer outro errno também pode ser especificado, tais erros não são determinísticos e o mesmo comportamento pode não ser mantido através de atualizações do sistema.

Valor devolvido

Retorna 0 para êxito ou -1 para falha, caso em que errno é definido como o valor de erro.

Requisitos do manifesto de aplicação

O manifesto do aplicativo deve incluir o recurso WifiConfig.