Dela via

WifiConfig_SetTargetedScanEnabled funktion

  • Artikel

Rubrik: #include <applibs/wificonfig.h>

Aktiverar eller inaktiverar riktad genomsö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 en bullrig miljö.

Inställningen gäller omedelbart men kommer inte att sparas mellan enhetsomstarter om inte funktionen WifiConfig_PersistConfig anropas efter den här funktionen.

Viktigt!

Riktad genomsökning gör att enheten skickar avsökningsbegäranden 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 acceptabel risk.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Parametrar

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

  • enabledtrue för att aktivera riktad genomsökning i nätverket, annars . false

Fel

Returnerar -1 om ett fel påträffas och anger errno felvärdet.

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

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

  • ENETDOWN: 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.