Função WifiConfig_SetTargetedScanEnabled
Cabeçalho: #include <applibs/wificonfig.h>
Habilita ou desabilita a verificação direcionada de uma rede. A verificação de destino é desabilitada por padrão.
A verificação direcionada é usada para se conectar a pontos de acesso que não estão transmitindo seu SSID ou estão em um ambiente barulhento.
A configuração é efetiva imediatamente, mas não persistirá entre reinicializações de dispositivo, a menos que a função WifiConfig_PersistConfig seja chamada após essa função.
Importante
A verificação direcionada faz com que o dispositivo transmita solicitações de investigação que podem revelar o SSID da rede para outros dispositivos. Isso só deve ser usado em ambientes controlados ou em redes em que esse é um risco aceitável.
static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);
Parâmetros
networkId
A ID da rede que você deseja configurar. Use WifiConfig_AddNetwork para retornar a ID de rede de uma rede recém-criada. A ID de rede é passada para funções WifiConfig_Set* 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
.
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.
EAGAIN: o dispositivo Wi-Fi não está pronto.
ENETDOWN: a interface de rede Wi-Fi não está disponível.
EINVAL: o
networkId
parâmetro é 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, nesse caso errno
é definido como o valor do erro.
Requisitos de manifesto do aplicativo
O manifesto do aplicativo deve incluir o recurso WifiConfig.