Networking_SetInterfaceState functie

  • Artikel

Header: #include <applibs/networking.h>

Hiermee schakelt u een netwerkinterface in of uit.

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

Parameters

  • networkInterfaceName De naam van de netwerkinterface die moet worden bijgewerkt.

  • isEnabled true om de interface in te schakelen, onwaar om deze uit te schakelen.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

  • EACCES: het toepassingsmanifest bevat niet de mogelijkheid NetworkConfig.

  • ENOENT: de netwerkinterface bestaat niet.

  • EPERM: deze functie is niet toegestaan op de interface.

  • EAGAIN: de netwerkstack is nog niet klaar.

  • EIO: de interface is niet toegankelijk.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet bewaard via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid NetworkConfig bevatten.

Concepten en voorbeelden

Opmerking

Als Wi-Fi is uitgeschakeld via Networking_SetInterfaceState bevindt het Wi-Fi subsysteem zich in de modus 'lichte slaapstand'. Dit zou ook de RF-emissies moeten uitschakelen. Als u echter de uitstoot moet beperken vanwege naleving of certificeringen, moet u ervoor zorgen dat u uw eigen metingen test en uitvoert.

In ontwerpen waarbij Wi-Fi niet vereist is, kunnen de RF-front-endonderdelen worden uitgesloten van het hardwareontwerp. Zie Wi-Fi RF-front-end uitschakelen op MT3620 voor meer informatie.