WifiConfig_GetScannedNetworks, fonction
En-tête : #include <applibs/wificonfig.h>
Obtient les réseaux Wi-Fi trouvés par la dernière opération d’analyse. Cette fonction n’est pas thread-safe.
Si
scannedNetworkArray
est trop petit pour contenir tous les réseaux, cette fonction remplit tous les éléments et retourne le nombre d’éléments de tableau.Si la fonctionnalité WiFiConfig n’est pas présente, la fonction retourne un tableau vide.
ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);
Paramètres
scannedNetworkArray
Pointeur vers un tableau qui retourne les réseaux Wi-Fi récupérés.scannedNetworkArrayCount
Nombre d’éléments analysésNetworkArray pouvant contenir. Le tableau doit avoir un élément pour chaque Wi-Fi réseau trouvé par la dernière opération d’analyse.
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
scannedNetworkArray
paramètre est NULL.ERANGE : le
scannedNetworkArrayCount
paramètre est 0.EINVAL : le
scannedNetworkArray
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 WifiConfig_ScannedNetwork retournés par scannedNetworkArray, 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.