Sdílet prostřednictvím


funkce Networking_SetInterfaceState

Hlavička: #include <applibs/networking.h>

Povolí nebo zakáže síťové rozhraní.

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

Parametry

  • networkInterfaceName Název síťového rozhraní, které se má aktualizovat.

  • isEnabled true povolíte rozhraní, false ho zakážete.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Manifest aplikace neobsahuje funkci NetworkConfig.

  • ENOENT: Síťové rozhraní neexistuje.

  • EPERM: Tato funkce není v rozhraní povolená.

  • EAGAIN: Síťový zásobník ještě není připravený.

  • EIO: Rozhraní je nepřístupné.

Je také možné zadat všechny ostatní errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí hodnotu 0 pro úspěch nebo -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci NetworkConfig.

Koncepty a ukázky

Poznámka

Pokud je Wi-Fi zakázána prostřednictvím Networking_SetInterfaceState bude subsystém Wi-Fi v režimu lehkého spánku. Tím by se také měly vypnout rf emise. Pokud ale musíte omezit emise z důvodu dodržování předpisů nebo certifikací, ujistěte se, že testujete a provádíte vlastní měření.

V návrzích, kde se nevyžaduje Wi-Fi, mohou být součásti front-endu RF vyloučeny z návrhu hardwaru. Další informace najdete v tématu Zakázání front-endu Wi-Fi RF v MT3620.