Partager via

WifiConfig_AddDuplicateNetwork, fonction

  • Article

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

Ajoute un nouveau réseau qui est un doublon du réseau spécifié avec l’ID spécifié. Le nouveau réseau reçoit le nom spécifié et est désactivé par défaut.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

Paramètres

  • networkId ID du réseau à dupliquer. WifiConfig_AddNetwork retourne l’ID réseau.

  • configName Pointeur vers un tableau d’octets qui contient le nom de la configuration. Le tableau doit avoir la valeur NULL terminée et au plus WIFICONFIG_CONFIG_NAME_MAX_LENGTH octets, à l’exception du caractère de terminaison.

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.

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

  • EEXIST : n’est configName pas unique.

  • EFAULT : a la configName valeur NULL.

  • EINVAL : n’est networkId pas valide.

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

  • ENODEV : ne networkId correspond à aucun des réseaux stockés.

  • ENOMEM : mémoire insuffisante pour ajouter un nouveau réseau.

  • ERANGE : a configName moins d’un caractère ou plus de WIFICONFIG_CONFIG_NAME_MAX_LENGTH caractères.

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 du nouveau réseau, ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur. L’ID réseau est zéro ou une valeur positive.

Remarques

Le nouveau réseau n’est pas configuré et peut être configuré avec les fonctions WifiConfig_Set* . Les modifications apportées à la configuration réseau prennent effet immédiatement, mais elles sont perdues lorsque l’appareil redémarre, sauf si la fonction WifiConfig_PersistConfig est appelée pour enregistrer la configuration dans un stockage non volatile.

Le nombre de réseaux que vous pouvez stocker sur un appareil n’est pas fixe, mais dépend des ressources disponibles et de la quantité de stockage nécessaire pour chaque configuration réseau.

Exigences du manifeste d’application

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