Aracılığıyla paylaş

WifiConfig_SetTargetedScanEnabled İşlevi

  • Makale

Üst bilgi: #include <applibs/wificonfig.h>

Bir ağ için hedeflenen taramayı etkinleştirir veya devre dışı bırakır. Hedeflenen tarama varsayılan olarak devre dışıdır.

Hedeflenen tarama, SSID'lerini yayınlamamış veya gürültülü bir ortamda bulunan erişim noktalarına bağlanmak için kullanılır.

Ayar hemen etkindir, ancak WifiConfig_PersistConfig işlevi bu işlevden sonra çağrılmadığı sürece cihaz yeniden başlatmalarında kalıcı olmaz.

Önemli

Hedeflenen tarama, cihazın ağın SSID'sini diğer cihazlara gösterebilecek yoklama isteklerini iletmesine neden olur. Bu yalnızca denetimli ortamlarda veya bunun kabul edilebilir bir risk olduğu ağlarda kullanılmalıdır.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Parametreler

  • networkId Yapılandırmak istediğiniz ağın kimliği. Yeni oluşturulan ağın ağ kimliğini döndürmek için WifiConfig_AddNetwork kullanın. Ağ kimliği yapılandırma için WifiConfig_Set* işlevlerine geçirilir. Tarama için hedeflenen SSID'yi belirtmek için WifiConfig_SetSSID kullanın.

  • enabledtrue ağda hedeflenen taramayı etkinleştirmek için; aksi takdirde , false.

Hatalar

Bir hatayla karşılaşılırsa ve hata değerine ayarlanırsa errno -1 döndürür.

  • EACCES: Uygulama bildirimi WifiConfig özelliğini içermez.

  • EAGAIN: Wi-Fi cihazı hazır değil.

  • ENETDOWN: Wi-Fi ağ arabirimi kullanılamıyor.

  • EINVAL: networkId parametresi geçersiz.

  • ENODEV: networkId parametresi depolanan ağlardan hiçbirinde eşleşmiyor.

Diğer errno hatalar da belirtilebilir; bu tür hatalar belirlenimci değildir ve sistem güncelleştirmeleri aracılığıyla aynı davranış korunmayabilir.

Dönüş değeri

Başarı için 0, hata için -1 döndürür; bu durumda errno hata değeri olarak ayarlanır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi WifiConfig özelliğini içermelidir.