WifiConfig_GetCurrentNetwork-Funktion

Header: #include <applibs/wificonfig.h>

Ruft ein Wi-Fi Netzwerk ab, das mit dem Gerät verbunden ist. Diese Funktion ist nicht threadsicher.

int WifiConfig_GetCurrentNetwork(WifiConfig_ConnectedNetwork * connectedNetwork);

Parameter

• connectedNetwork Ein Zeiger auf eine WifiConfig_ConnectedNetwork Struktur, die das verbundene Wi-Fi Netzwerk zurückgibt.

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.

• EFAULT: ist ssid NULL.

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

• EINVAL: Die storedNetwork Strukturversion oder deren Strukturversion ist ungültig.

• EAGAIN: Das Wi-Fi Gerät ist noch 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 dasselbe Verhalten wird möglicherweise nicht durch 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 an das Anwendungsmanifest

Das Anwendungsmanifest muss die WifiConfig-Funktion enthalten.