Função WifiConfig_SetTargetedScanEnabled

  • Artigo

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

Habilita ou desabilita a verificação direcionada de uma rede. A verificação de destino está desabilitada por padrão.

A verificação de destino é usada para se conectar a pontos de acesso que não estão transmitindo o respectivo SSID ou que estão em um ambiente barulhento.

A configuração entra em vigor imediatamente, mas não persiste nas reinicializações do dispositivo, a menos que a função WifiConfig_PersistConfig seja chamada após essa função.

Importante

A verificação direcionada faz o dispositivo transmitir solicitações de investigação que podem revelar o SSID da rede para outros dispositivos. Isso deve ser usado apenas em ambientes controlados ou em redes em que isso é um risco aceitável.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Parâmetros

  • networkId O ID da rede que você deseja configurar. Use WifiConfig_AddNetwork para retornar a ID de rede de uma rede recém-criada. O ID de rede é passado para WifiConfig_Set* funções para configuração. Use WifiConfig_SetSSID para especificar o SSID a ser direcionado para a verificação.

  • enabled true para habilitar a verificação direcionada na rede; caso contrário, false.

Errors

Retorna -1 se um erro for encontrado e definido errno como o valor do erro.

  • EACCES: o manifesto do aplicativo não inclui a funcionalidade WifiConfig.

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

  • ENETDOWN: o adaptador de rede Wi-Fi não está disponível.

  • EINVAL: o parâmetro networkId é inválido.

  • ENODEV: o networkId parâmetro não corresponde a nenhuma das redes armazenadas.

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 0 para êxito ou -1 para falha, caso errno em que é definido como o valor de erro.

Requisitos do manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso WifiConfig.