WifiConfig_AddNetwork-Funktion

Header: #include <applibs/wificonfig.h>

Fügt dem Gerät ein Wi-Fi Netzwerk hinzu und gibt die ID des Netzwerks zurück.

int WifiConfig_AddNetwork(void);

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.

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

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

• ENOMEM: Es ist nicht genügend Arbeitsspeicher vorhanden, um ein neues Netzwerk hinzuzufügen.

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 die ID des neuen Netzwerks oder -1 für einen Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt. Die Netzwerk-ID ist 0 (null) oder ein positiver Wert.

Bemerkungen

Die Netzwerk-ID wird an WifiConfig_Set*- Funktionen wie WifiConfig_SetSSID übergeben.

Das neue Netzwerk ist nicht konfiguriert und kann mit den funktionen WifiConfig_Set* konfiguriert werden. Änderungen an der Netzwerkkonfiguration werden sofort wirksam, gehen aber beim Neustart des Geräts verloren, es sei denn, die funktion WifiConfig_PersistConfig wird aufgerufen, um die Konfiguration im nicht flüchtigen Speicher zu speichern.

Die Anzahl der Netzwerke, die Sie auf einem Gerät speichern können, ist nicht festgelegt, sondern hängt von den verfügbaren Ressourcen und der Menge des erforderlichen Speichers für jede Netzwerkkonfiguration ab.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die WifiConfig-Funktion enthalten.