Compartilhar via

Função WifiConfig_ForgetNetwork

  • Artigo

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

Importante

Essa função é obsoleta. Use WifiConfig_ForgetNetworkById em vez disso.

Remove uma rede Wi-Fi do dispositivo. Desconecta o dispositivo da rede se ele estiver conectado no momento. Essa função não é thread safe.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parâmetros

Erros

Retorna -1 se um erro for encontrado e definir errno como o valor do erro.

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

  • EFAULT: o ssid parâmetro é NULL.

  • ENOENT: o storedNetwork parâmetro não corresponde a nenhuma das redes armazenadas.

  • EINVAL: o storedNetwork parâmetro ou sua versão struct é inválido.

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

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

  • ENOSPC: há muitas redes Wi-Fi para a configuração persistir; remova um e tente novamente.

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

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso WifiConfig.