Função WifiConfig_SetTargetedScanEnabled

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

Habilita ou desabilita a varredura direcionada para uma rede. A análise direcionada está desativada por predefiniçã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 entra em vigor imediatamente, mas não persistirá 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 com que o dispositivo transmita solicitações de teste que podem revelar o SSID da rede para outros dispositivos. Este só deve ser utilizado em ambientes controlados ou em redes em que este seja 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. O ID de rede é passado para as funções WifiConfig_set* para configuração. Use WifiConfig_SetSSID para especificar o SSID a ser direcionado para a verificação.

• enabledtrue para permitir a varredura direcionada na rede; caso contrário, false.

Erros

Retorna -1 se um erro for encontrado e define errno como o valor de 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, tais erros não são determinísticos e o mesmo comportamento pode não ser mantido através de atualizações do sistema.

Valor devolvido

Retorna 0 para êxito ou -1 para falha, caso em que errno é definido como o valor de erro.

Requisitos do manifesto de aplicação

O manifesto do aplicativo deve incluir o recurso WifiConfig.