Condividi tramite

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 a punti di accesso che non trasmettono il proprio SSID o che si trovano in un ambiente rumoroso.

L'impostazione viene applicata immediatamente, ma non viene mantenuta da un riavvio all'altro del dispositivo, a meno che non venga chiamata la funzione WifiConfig_PersistConfig dopo questa funzione.

Importante

Se l'analisi mirata è abilitata, il dispositivo trasmette richieste di probe che possono rivelare l'identificatore SSID della rete ad altri dispositivi. Tale funzionalità deve pertanto essere usata solo in ambienti controllati o su reti in cui il livello di 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 rete appena creata. L'ID di rete viene passato alle funzioni WifiConfig_Set* per la configurazione. Usare WifiConfig_SetSSID per specificare L'SSID come destinazione per l'analisi.

  • enabled true per abilitare l'analisi mirata della rete; in caso contrario, false.

Errori

Restituisce -1 se viene rilevato 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 parametro networkId non è valido.

  • ENODEV: il networkId parametro non corrisponde ad alcuna delle reti archiviate.

È anche possibile specificare qualsiasi altra errno opzione. Tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce 0 per esito positivo o -1 per errore, nel qual caso errno viene impostato sul valore di errore.

Requisiti del manifesto dell'applicazione

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