Compartir vía

Función WifiConfig_AddDuplicateNetwork

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Agrega una nueva red que es un duplicado de la red especificada con el id. especificado. La nueva red tiene asignado el nombre especificado y está deshabilitada de forma predeterminada.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

Parámetros

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

  • configName Puntero a una matriz de bytes que contiene el nombre de configuración. La matriz debe terminarse con NULL y, como máximo, WIFICONFIG_CONFIG_NAME_MAX_LENGTH bytes, excluyendo el carácter de 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.

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

  • EEXIST: el configName no es único.

  • EFAULT: el configName es NULL.

  • EINVAL: el networkId valor no es válido.

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

  • ENODEV: la networkId no coincide con ninguna de las redes almacenadas.

  • ENOMEM: no hay suficiente memoria para añadir una nueva red.

  • ERANGE: tiene configName menos de un carácter o más de WIFICONFIG_CONFIG_NAME_MAX_LENGTH caracteres.

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 la nueva red o -1 en caso de error, en cuyo caso errno se establece en el valor de error. El id. de red es cero o un valor positivo.

Observaciones

La nueva red no está configurada y se puede configurar con las funciones WifiConfig_Set* . Los cambios en la configuración de la red son efectivos inmediatamente, pero se pierden cuando el dispositivo se reinicia a menos que se llame a la función WifiConfig_PersistConfig para guardar la configuración en un almacenamiento no móvil.

El número de redes que puede almacenar en un dispositivo no es fijo, pero depende de los recursos disponibles y de la cantidad de almacenamiento necesario para cada configuración de red.

Requisitos del manifiesto de la aplicación

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