WifiConfig_GetConnectedNetworkId-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Ruft die Netzwerk-ID des aktuell verbundenen Netzwerks ab.

Die Netzwerk-ID kann sich ändern, wenn Netzwerkkonfigurationen hinzugefügt und entfernt werden. Wenn das Gerät neu gestartet oder Netzwerkkonfigurationen hinzugefügt oder entfernt wurden, sollte die Anwendung die aktuelle Netzwerk-ID abrufen, bevor sie gespeicherte Netzwerkkonfigurationen ändert.

int WifiConfig_GetConnectedNetworkId();

Parameter

Nichts.

Fehler

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

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

  • ENOTCONN: Das Gerät ist derzeit nicht mit einem Netzwerk verbunden.

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

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

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und es gibt keine Garantie, dass das gleiche Verhalten durch Systemupdates beibehalten wird.

Rückgabewert

Gibt die Netzwerk-ID des verbundenen Netzwerks oder -1 für einen Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die WifiConfig-Funktion enthalten.