Partager via


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.