Compartir a través de

Función WifiConfig_GetStoredNetworks

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Recupera todas las redes Wi-Fi almacenadas en el dispositivo. Esta función no es segura para subprocesos.

Nota

Antes de llamar a WifiConfig_GetStoredNetworks, debe llamar a WifiConfig_GetStoredNetworkCount y usar el resultado como el tamaño de la matriz de WifiConfig_StoredNetwork que se pasa como storedNetworkArray parámetro.

  • Si storedNetworkArray es demasiado pequeña para contener todas las redes de Wi-Fi almacenadas, esta función rellena la matriz y devuelve el número de elementos de matriz.

  • Si la funcionalidad WiFiConfig no está presente, la función devuelve una matriz vacía.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parámetros

  • storedNetworkArray Puntero a una matriz que devuelve las redes Wi-Fi almacenadas.

  • storedNetworkArrayCount El número de elementos storedNetworkArray puede contener. La matriz debe tener un elemento para cada red Wi-Fi almacenada.

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 storedNetworkArray parámetro es NULL.

  • ERANGE: el storedNetworkArrayCount parámetro es 0.

  • EINVAL: el storedNetworkArray parámetro o su versión struct no es válida.

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

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 número de elementos de la matriz WifiConfig_StoredNetwork 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.