Sdílet prostřednictvím

WifiConfig_SetTargetedScanEnabled – funkce

  • Článek

Hlavička: #include <applibs/wificonfig.h>

Povolí nebo zakáže cílené vyhledávání sítě. Výběrová kontrola je ve výchozím nastavení zakázaná.

Výběrová kontrola se používá pro připojení k přístupovým bodům, které nevysílají jejich identifikátor SSID, nebo jsou v hlučném prostředí.

Nastavení je efektivní okamžitě, ale po restartování zařízení se neuchová, pokud se po této funkci nevyvolá funkce WifiConfig_PersistConfig .

Důležité

Cílené prohledávání způsobí, že zařízení bude přenášet požadavky sondy, které mohou odhalit identifikátor SSID sítě do jiných zařízení. Tato možnost by se měla používat pouze v kontrolovaných prostředích nebo v sítích, kde je toto přijatelné riziko.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Parametry

  • networkId ID sítě, kterou chcete nakonfigurovat. K vrácení ID sítě nově vytvořené sítě použijte WifiConfig_AddNetwork . ID sítě se předává funkcím WifiConfig_Set* pro konfiguraci. Pomocí WifiConfig_SetSSID zadejte identifikátor SSID, který má být cílem kontroly.

  • enabledtrue pro povolení cílené kontroly v síti; falsev opačném případě .

Chyby

Vrátí hodnotu -1, pokud dojde k chybě a nastaví errno se na chybovou hodnotu.

  • EACCES: Manifest aplikace nezahrnuje funkci WifiConfig.

  • EAGAIN: Zařízení Wi-Fi není připravené.

  • ENETDOWN: Síťové rozhraní Wi-Fi není k dispozici.

  • EINVAL: networkId Parametr je neplatný.

  • ENODEV: networkId Parametr neodpovídá žádné uložené síti.

Je také možné zadat jakékoli jiné errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí hodnotu 0 pro úspěch nebo -1 pro selhání, v takovém případě errno je nastavena na chybovou hodnotu.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci WifiConfig.