Partilhar via

Função WifiConfig_GetScannedNetworks

  • Artigo

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

Obtém as redes Wi-Fi encontradas pela última operação de análise. Esta função não é segura para threads.

  • Se scannedNetworkArray for demasiado pequena para conter todas as redes, esta função preenche todos os elementos 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_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Parâmetros

  • scannedNetworkArray Um ponteiro para uma matriz que devolve as redes Wi-Fi obtidas.

  • scannedNetworkArrayCount O número de elementos scannedNetworkArray pode conter. A matriz deve ter um elemento para cada rede Wi-Fi encontrada pela última operação de análise.

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

  • ERANGE: o scannedNetworkArrayCount parâmetro é 0.

  • EINVAL: o parâmetro ou a scannedNetworkArray 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 WifiConfig_ScannedNetwork devolvidos por scannedNetworkArray 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.