Compartir vía

Función WifiConfig_GetNetworkIdByConfigName

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Obtiene el id. de red para la configuración de red con el nombre dado. Use WifiConfig_SetConfigName para asignar el nombre de red. El id. de red puede cambiar a medida que se agregan y quitan las configuraciones de red, por lo que las aplicaciones deben volver a obtener el id. de red antes de cambiar una configuración de red almacenada.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Parámetros

  • configName Un puntero al nombre de la configuración de red. Este nombre se estableció con WifiConfig_SetConfigName. La cadena debe ser NULL terminado y ser menor o igual que WIFICONFIG_CONFIG_NAME_MAX_LENGTH bytes (excluyendo la terminación).

Errores

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

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

  • EFAULT: el configName parámetro es NULL.

  • ERANGE: el configName parámetro es mayor que WIFICONFIG_SSID_MAX_LENGTH.

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

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

  • ENODEV: no se puede encontrar la configuración de red especificada.

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

Valor devuelto

Devuelve el id. de red de la red especificada (valor no negativo) o -1 para un error, en cuyo caso errno se establece en el valor de error. El id. de red se pasa a las funciones de WifiConfig_Setxxx como identificador de la red que se va a configurar.

Requisitos del manifiesto de la aplicación

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