Função WifiConfig_SetTargetedScanEnabled
Cabeçalho: #include <applibs/wificonfig.h>
Ativa ou desativa a análise direcionada para uma rede. A análise direcionada está desativada por predefinição.
A análise direcionada é utilizada para ligar a pontos de acesso que não estão a difundir o SSID ou que estão num ambiente ruidoso.
A definição tem efeito imediato, mas não persiste entre reinícios do dispositivo, a menos que a função WifiConfig_PersistConfig seja chamada após esta função.
Importante
A análise direcionada faz com que o dispositivo transmita pedidos de sonda que podem revelar o SSID da rede para outros dispositivos. Esta ação só deve ser utilizada em ambientes controlados ou em redes em que se trata de um risco aceitável.
static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);
Parâmetros
networkId
O ID da rede que pretende configurar. Utilize WifiConfig_AddNetwork para devolver o ID de rede de uma rede criada recentemente. O ID de rede é transmitido para as funções WifiConfig_Set* para configuração. Utilize WifiConfig_SetSSID para especificar o SSID a direcionar para a análise.enabled
true
para ativar a análise direcionada na rede; caso contrário,false
.
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.
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.
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 0 para êxito ou -1 para 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.