Partilhar via

Função WifiConfig_GetStoredNetworks

  • Artigo

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

Obtém todas as redes de Wi-Fi armazenadas no dispositivo. Esta função não é segura para threads.

Nota

Antes de chamar WifiConfig_GetStoredNetworks, tem de chamar WifiConfig_GetStoredNetworkCount e utilizar o resultado como o tamanho da matriz para a matriz WifiConfig_StoredNetwork que é transmitida como o storedNetworkArray parâmetro .

  • Se storedNetworkArray for demasiado pequena para conter todas as redes de Wi-Fi armazenadas, esta função preenche a matriz e devolve o número de elementos de matriz.

  • Se a capacidade WiFiConfig não estiver presente, a função devolve uma matriz vazia.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parâmetros

  • storedNetworkArray Um ponteiro para uma matriz que devolve as redes de Wi-Fi armazenadas.

  • storedNetworkArrayCount O número de elementos storedNetworkArray pode conter. A matriz deve ter um elemento para cada rede Wi-Fi armazenada.

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 storedNetworkArray parâmetro é NULL.

  • ERANGE: o storedNetworkArrayCount parâmetro é 0.

  • EINVAL: o parâmetro ou a storedNetworkArray respetiva versão de estrutura é inválido.

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

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 o número de elementos na matriz WifiConfig_StoredNetwork ou -1 para a 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.