Função WifiConfig_GetStoredNetworks

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.