Partager via

WifiConfig_GetStoredNetworks, fonction

  • Article

En-tête : #include <applibs/wificonfig.h>

Récupère tous les réseaux Wi-Fi stockés sur l’appareil. Cette fonction n’est pas thread-safe.

Note

Avant d’appeler WifiConfig_GetStoredNetworks, vous devez appeler WifiConfig_GetStoredNetworkCount et utiliser le résultat comme taille de tableau pour le tableau WifiConfig_StoredNetwork passé en tant que storedNetworkArray paramètre.

  • Si storedNetworkArray est trop petit pour contenir tous les réseaux Wi-Fi stockés, cette fonction remplit le tableau et retourne le nombre d’éléments du tableau.

  • Si la fonctionnalité WiFiConfig n’est pas présente, la fonction retourne un tableau vide.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Paramètres

  • storedNetworkArray Pointeur vers un tableau qui retourne les réseaux Wi-Fi stockés.

  • storedNetworkArrayCount Nombre d’éléments storedNetworkArray pouvant contenir. Le tableau doit avoir un élément pour chaque réseau Wi-Fi stocké.

Erreurs

Retourne -1 si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EACCES : le manifeste de l’application n’inclut pas la fonctionnalité WifiConfig.

  • EFAULT : le storedNetworkArray paramètre est NULL.

  • ERANGE : le storedNetworkArrayCount paramètre est 0.

  • EINVAL : le storedNetworkArray paramètre ou sa version de struct n’est pas valide.

  • EAGAIN : l’appareil Wi-Fi n’est pas encore prêt.

Toutes les autres errno peuvent également être spécifiées ; ces erreurs ne sont pas déterministes et le même comportement peut ne pas être conservé par le biais des mises à jour système.

Valeur de retour

Retourne le nombre d’éléments dans le tableau WifiConfig_StoredNetwork , ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur.

Exigences du manifeste d’application

Le manifeste de l’application doit inclure la fonctionnalité WifiConfig.