Compartilhar via

Função WifiConfig_GetStoredNetworks

  • Artigo

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

Recupera todas as redes de Wi-Fi armazenadas no dispositivo. Essa função não é thread safe.

Nota

Antes de chamar WifiConfig_GetStoredNetworks, você deve chamar WifiConfig_GetStoredNetworkCount e usar o resultado como o tamanho da matriz para a matriz WifiConfig_StoredNetwork que é passada como o storedNetworkArray parâmetro.

  • Se storedNetworkArray for muito pequena para manter todas as redes de Wi-Fi armazenadas, essa função preencherá a matriz e retornará o número de elementos de matriz.

  • Se o recurso WiFiConfig não estiver presente, a função retornará uma matriz vazia.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parâmetros

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

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

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

  • ERANGE: o storedNetworkArrayCount parâmetro é 0.

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

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

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