Partager via


WifiConfig_GetNetworkIdByConfigName, fonction

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

Obtient l’ID réseau de la configuration réseau avec le nom donné. Utilisez WifiConfig_SetConfigName pour attribuer le nom réseau. L’ID réseau peut changer à mesure que des configurations réseau sont ajoutées et supprimées. Les applications doivent donc récupérer l’ID réseau avant de modifier une configuration réseau stockée.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Paramètres

  • configName Pointeur vers le nom de la configuration réseau. Ce nom a été défini à l’aide de WifiConfig_SetConfigName. La chaîne doit être terminée par NULL et être inférieure ou égale à WIFICONFIG_CONFIG_NAME_MAX_LENGTH des octets (à l’exception de l’arrêt).

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 configName paramètre est NULL.

  • ERANGE : le configName paramètre est supérieur à WIFICONFIG_SSID_MAX_LENGTH.

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

  • ENETDOWN : l’interface réseau Wi-Fi n’est pas disponible.

  • ENODEV : la configuration réseau spécifiée est introuvable.

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 l’ID réseau du réseau spécifié (valeur non négative) ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur. L’ID réseau est passé à l’WifiConfig_Setxxx fonctionne comme identificateur du réseau à configurer.

Exigences du manifeste d’application

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