Dela via

funktionen WifiConfig_SetTargetedScanEnabled

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Aktiverar eller inaktiverar riktad sökning efter ett nätverk. Riktad genomsökning är inaktiverad som standard.

Riktad genomsökning används för att ansluta till åtkomstpunkter som inte sänder sitt SSID eller som är i bullriga miljöer.

Inställningen börjar gälla omedelbart men finns inte kvar på alla enhetsstarter om inte funktionen WifiConfig_PersistConfig anropas efter den här funktionen.

Viktigt

Riktad genomsökning gör att enheten överför sondförfrågningar som kan avslöja nätverkets SSID till andra enheter. Detta bör endast användas i kontrollerade miljöer eller i nätverk där detta är en godtagbar risk.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Parametrar

  • networkId ID för nätverket som du vill konfigurera. Använd WifiConfig_AddNetwork för att returnera nätverks-ID för ett nyligen skapat nätverk. Nätverks-ID:t skickas till WifiConfig_Set* funktioner för konfiguration. Använd WifiConfig_SetSSID för att ange det SSID som ska användas som mål för genomsökningen.

  • enabledtrue för att möjliggöra riktad genomsökning i nätverket. i annat fall false.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: programmanifestet innehåller inte WifiConfig-funktionen.

  • EAGAIN: Wi-Fi-enheten är inte klar.

  • ENETDOWN: det Wi-Fi nätverksgränssnittet är inte tillgängligt.

  • EINVAL: parametern networkId är ogiltig.

  • ENODEV: parametern networkId matchar inte något av de lagrade nätverken.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar 0 för lyckat resultat, eller -1 för fel, i vilket fall errno är inställt på felvärdet.

Krav för programmanifest

Programmanifestet måste innehålla WifiConfig-funktionen.