Função WifiConfig_ForgetNetwork

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

Remove uma rede Wi-Fi do dispositivo. Desliga o dispositivo da rede se estiver atualmente ligado. Esta função não é segura para threads.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parâmetros

• storedNetwork Ponteiro para uma estrutura de WifiConfig_StoredNetwork que descreve a rede de Wi-Fi armazenada a remover.

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 WifiConfig.

• EFAULT: o ssid parâmetro é NULL.

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

• EINVAL: o parâmetro ou a storedNetwork respetiva versão de estrutura é 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: existem demasiadas redes Wi-Fi para que a configuração persista; remova uma e tente novamente.

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 WifiConfig.