Função WifiConfig_GetScannedNetworks

  • Artigo

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

Obtém as redes de Wi-Fi encontradas pela última operação de verificação. Essa função não é thread safe.

  • Se scannedNetworkArray for muito pequena para manter todas as redes, essa função preencherá todos os elementos 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_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Parâmetros

  • scannedNetworkArray Um ponteiro para uma matriz que retorna as redes de Wi-Fi recuperadas.

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

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

  • ERANGE: o scannedNetworkArrayCount parâmetro é 0.

  • EINVAL: o scannedNetworkArray 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 WifiConfig_ScannedNetwork retornados pelo scannedNetworkArray 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.