Partager via

WifiConfig_SetConfigName, fonction

  • Article

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

Définit un nom pour une configuration réseau. Le nom peut être utilisé comme handle pratique pour identifier une configuration réseau. Il est fortement recommandé que ce nom soit unique.

Le paramètre est effectif immédiatement, mais ne sera pas conservé sur les redémarrages de l’appareil, sauf si la fonction WifiConfig_PersistConfig est appelée après cette fonction.

static int WifiConfig_SetConfigName(int networkId, const char *configName);

Paramètres

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

  • configname Pointeur vers un tableau d’octets contenant le nom de configuration. Le tableau d’octets doit être terminé par NULL et être inférieur ou égal à 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_CONFIG_NAME_MAX_LENGTH.

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

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

  • EINVAL : le networkId paramètre n’est pas valide.

  • ENODEV : le networkId paramètre ne correspond à aucun des ID des réseaux stockés.

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 0 pour la réussite, 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.