Compartir a través de

Función WifiConfig_SetTargetedScanEnabled

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Habilita o deshabilita el examen dirigido en una red. El examen dirigido está deshabilitado de manera predeterminada.

Se usa para conectarse a puntos de acceso que no difunden su SSID o que se encuentran en un entorno ruidoso.

La configuración es efectiva de inmediato, pero no se conservará entre reinicios del dispositivo a menos que se llame a la función WifiConfig_PersistConfig después de esta función.

Importante

El examen dirigido hace que el dispositivo transmita solicitudes de sondeo que pueden revelar el SSID de la red a otros dispositivos. Solo se debe usar en entornos controlados o en redes en las que esta situación sea un riesgo aceptable.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Parámetros

  • networkId Identificador de la red que desea configurar. Use WifiConfig_AddNetwork para devolver el identificador de red de una red recién creada. El identificador de red se pasa a las funciones WifiConfig_Set* para la configuración. Use WifiConfig_SetSSID para especificar el SSID de destino para el examen.

  • enabled true para habilitar el examen dirigido de la red; de lo contrario, false.

Errores

Devuelve -1 si se encuentra un error y establece errno en el valor de error.

  • EACCES: el manifiesto de aplicación no incluye la funcionalidad WifiConfig.

  • EAGAIN: el dispositivo Wi-Fi no está listo.

  • ENETDOWN: la interfaz de red Wi-Fi no está disponible.

  • EINVAL: el parámetro networkId no es válido.

  • ENODEV: el networkId parámetro no coincide con ninguna de las redes almacenadas.

Cualquier otro errno también se puede especificar; estos errores no son deterministas y es posible que el mismo comportamiento no se conserve a través de las actualizaciones del sistema.

Valor devuelto

Devuelve 0 para éxito o -1 para el error, en cuyo caso errno se establece en el valor de error.

Requisitos del manifiesto de aplicación

El manifiesto de aplicación debe incluir la funcionalidad WifiConfig.