WifiConfig_SetTargetedScanEnabled functie

Header: #include <applibs/wificonfig.h>

Hiermee schakelt u gerichte scans voor een netwerk in of uit. Gericht scannen is standaard uitgeschakeld.

Gerichte scans worden gebruikt om verbinding te maken met toegangspunten die hun SSID niet uitzenden of zich in een lawaaierige omgeving bevinden.

De instelling is onmiddellijk van kracht, maar blijft niet behouden wanneer het apparaat opnieuw wordt opgestart, tenzij de functie WifiConfig_PersistConfig wordt aangeroepen na deze functie.

Belangrijk

Gerichte scan zorgt ervoor dat het apparaat testaanvragen verzendt die de SSID van het netwerk naar andere apparaten kunnen onthullen. Dit mag alleen worden gebruikt in gecontroleerde omgevingen of op netwerken waar dit een acceptabel risico is.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Parameters

• networkId De id van het netwerk dat u wilt configureren. Gebruik WifiConfig_AddNetwork om de netwerk-id van een nieuw gemaakt netwerk te retourneren. De netwerk-id wordt voor configuratie doorgegeven aan WifiConfig_Set* -functies. Gebruik WifiConfig_SetSSID om de SSID voor de scan op te geven.

• enabledtrue gericht scannen op het netwerk mogelijk te maken; anders, false.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

• EACCES: het toepassingsmanifest bevat niet de mogelijkheid WifiConfig.

• EAGAIN: het Wi-Fi apparaat is niet gereed.

• ENETDOWN: de Wi-Fi netwerkinterface is niet beschikbaar.

• EINVAL: de networkId parameter is ongeldig.

• ENODEV: de networkId parameter komt niet overeen met een van de opgeslagen netwerken.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet bewaard via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.