Teilen über

WifiConfig_SetNetworkEnabled-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Aktiviert oder deaktiviert eine WLAN-Netzwerkkonfiguration.

Die Einstellung wird sofort wirksam, bleibt aber bei einem Geräteneustart nicht erhalten, es sei denn, die Funktion WifiConfig_PersistConfig wird nach dieser Funktion aufgerufen.

static int WifiConfig_SetNetworkEnabled(int networkId, bool enabled);

Parameter

  • networkId: Die ID des zu konfigurierenden Netzwerks. WifiConfig_AddNetwork gibt die Netzwerk-ID zurück.

  • enabled: true, um das Netzwerk zu aktivieren, andernfalls false

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt und auf den Fehlerwert festgelegt errno wird.

  • EACCES: Das Anwendungsmanifest enthält nicht die WifiConfig-Funktion.

  • EAGAIN: Das WLAN-Gerät ist nicht bereit.

  • ENETDOWN: Die WLAN-Netzwerkschnittstelle ist nicht verfügbar.

  • EINVAL: Der Parameter networkId ist ungültig.

  • ENODEV: Der Parameter networkId stimmt mit keiner der IDs der gespeicherten Netzwerke überein.

Alle anderen errno können auch angegeben werden; solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht über Systemupdates beibehalten.

Rückgabewert

Gibt 0 für Erfolg oder -1 für Fehler zurück, in diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen für das Anwendungsmanifest

Das Anwendungsmanifest muss die Funktion „WifiConfig“ enthalten.