Funzione WifiConfig_SetTargetedScanEnabled

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Abilita o disabilita l'analisi mirata per una rete. L'analisi mirata è disabilitata per impostazione predefinita.

L'analisi mirata viene usata per connettersi ai punti di accesso che non stanno trasmettendo il loro SSID o che si trovano in un ambiente rumoroso.

L'impostazione è immediatamente valida, ma non viene mantenuta nei riavvii del dispositivo, a meno che la funzione WifiConfig_PersistConfig non venga chiamata dopo questa funzione.

Importante

La scansione mirata fa sì che il dispositivo trasmetta le richieste di probe che potrebbero rivelare il SSID della rete ad altri dispositivi. Questo deve essere usato solo in ambienti controllati o in reti in cui questo rischio è accettabile.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Parametri

  • networkId ID della rete da configurare. Usare WifiConfig_AddNetwork per restituire l'ID di rete di una nuova rete creata. L'ID di rete viene passato alle funzioni WifiConfig_Set* per la configurazione. Usare WifiConfig_SetSSID per specificare l'SSID di destinazione per l'analisi.

  • enabledtrue per abilitare la scansione mirata sulla rete; in caso contrario, false.

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EACCES: il manifesto dell'applicazione non include la funzionalità WifiConfig.

  • EAGAIN: il dispositivo Wi-Fi non è pronto.

  • ENETDOWN: l'interfaccia di rete Wi-Fi non è disponibile.

  • EINVAL: il networkId parametro non è valido.

  • ENODEV: il networkId parametro non corrisponde a nessuna delle reti archiviate.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce 0 per operazione riuscita o -1 per errore, nel qual caso errno è impostato sul valore di errore.

Requisiti del manifesto dell'applicazione

Il manifesto dell'applicazione deve includere la funzionalità WifiConfig.