Partager via

Networking_SetInterfaceState, fonction

  • Article

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

Active ou désactive une interface réseau.

int Networking_SetInterfaceState(const char *networkInterfaceName, bool isEnabled);

Paramètres

  • networkInterfaceName Nom de l’interface réseau à mettre à jour.

  • isEnabled true pour activer l’interface, false pour la désactiver.

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é NetworkConfig.

  • ENOENT : l’interface réseau n’existe pas.

  • EPERM : cette fonction n’est pas autorisée sur l’interface.

  • EAGAIN : la pile réseau n’est pas encore prête.

  • EIO : l’interface est inaccessible.

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é NetworkConfig.

Concepts et exemples

Note

Si Wi-Fi est désactivé via Networking_SetInterfaceState le sous-système Wi-Fi sera en mode « veille légère ». Cela devrait également arrêter les émissions rf. Toutefois, si vous êtes tenu de limiter les émissions en raison de la conformité ou des certifications, vérifiez que vous testez et effectuez vos propres mesures.

Dans les conceptions où Wi-Fi n’est pas nécessaire, les composants frontaux RF peuvent être exclus de la conception matérielle. Pour plus d’informations, consultez Désactiver Wi-Fi front-end RF sur MT3620.