Udostępnij za pośrednictwem

Funkcja Networking_SetInterfaceState

  • Artykuł

Nagłówek: #include <applibs/networking.h>

Włącza lub wyłącza interfejs sieciowy.

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

Parametry

  • networkInterfaceName Nazwa interfejsu sieciowego do zaktualizowania.

  • isEnabled true, aby włączyć interfejs, fałsz, aby go wyłączyć.

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EACCES: manifest aplikacji nie zawiera funkcji NetworkConfig.

  • ENOENT: interfejs sieci nie istnieje.

  • EPERM: ta funkcja nie jest dozwolona w interfejsie.

  • EAGAIN: stos sieci nie jest jeszcze gotowy.

  • EIO: interfejs jest niedostępny.

Mogą być również określone inne errno błędy; takie błędy nie są deterministyczne i to samo zachowanie może nie być zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca wartość 0 dla powodzenia lub -1 dla niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję NetworkConfig.

Pojęcia i próbki

Uwaga

Jeśli Wi-Fi jest wyłączona za pośrednictwem Networking_SetInterfaceState podsystem Wi-Fi będzie w trybie "jasnego uśpienia". Powinno to również spowodować wyłączenie emisji fal radiowych. Jeśli jednak musisz ograniczyć emisje ze względu na zgodność z przepisami lub certyfikaty, upewnij się, że testujesz i przeprowadzasz własne pomiary.

W projektach, w których Wi-Fi nie jest wymagane, komponenty frontonu fal radiowych można wykluczyć z konstrukcji sprzętu. Aby uzyskać więcej informacji, zobacz Wyłączanie Wi-Fi przedniego krańca fal radiowych na MT3620.