Compartir vía

Función WifiConfig_SetConfigName

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Establece un nombre para una configuración de red. El nombre se puede utilizar como un práctico controlador para identificar una configuración de red. Se recomienda encarecidamente que este nombre sea único.

La configuración se aplica inmediatamente, pero no se conservará en todos los reinicios del dispositivo, a menos que se llame a la función WifiConfig_PersistConfig después de esta función.

static int WifiConfig_SetConfigName(int networkId, const char *configName);

Parámetros

  • networkId El id. de la red que se va a configurar. WifiConfig_AddNetwork devuelve el id. de red.

  • configname Puntero a una matriz de bytes que contiene el nombre de configuración. La matriz de bytes debe terminarse en NULL 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_CONFIG_NAME_MAX_LENGTH.

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

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

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

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

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 0 para éxito o -1 para error, en cuyo caso errno se establece en el valor de error.

Requisitos del manifiesto de la aplicación

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