Sdílet prostřednictvím

funkce WifiConfig_SetTargetedScanEnabled

  • Článek

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

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

Cílená kontrola se používá k připojení k přístupovým bodům, které nevysílají svůj identifikátor SSID nebo jsou v hlučné prostředí.

Nastavení je účinné okamžitě, ale nezachová se při restartování zařízení, pokud se po této funkci nezavolá funkce WifiConfig_PersistConfig .

Důležité

Cílená kontrola způsobí, že zařízení bude přenášet požadavky sond, které můžou odhalit identifikátor SSID sítě do jiných zařízení. To by se mělo používat jenom v kontrolovaných prostředích nebo v sítích, kde to představuje 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á WifiConfig_Set* funkcím konfigurace. Pomocí WifiConfig_SetSSID určete identifikátor SSID, na který se má kontrola zaměřit.

  • enabledtrues cílem umožnit cílené vyhledávání v síti; v opačném případě . false

Chyby

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

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

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

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

  • EINVAL: networkId Parametr je neplatný.

  • ENODEV: networkId Parametr neodpovídá žádné z uložených sítí.

Je také možné zadat všechny ostatní 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 tomto případě errno je nastavená na chybovou hodnotu.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci WifiConfig.