Share via

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 bu işlevden sonra WifiConfig_PersistConfig işlevi ç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);

Parametre

  • 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ğdaki hedefli taramayı etkinleştirmek için; aksi takdirde , false.

Hata

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 parametre geçersiz.

  • ENODEV: networkId parametresi depolanan ağların 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 veya hata için -1 döndürür; bu durumda errno hata değerine ayarlanır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi WifiConfig özelliğini içermelidir.