WifiConfig_AddDuplicateNetwork-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Fügt ein neues Netzwerk hinzu, das ein Duplikat des angegebenen Netzwerks mit der angegebenen ID ist. Dem neuen Netzwerk wird der angegebene Name zugewiesen und ist standardmäßig deaktiviert.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

Parameter

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

  • configName Ein Zeiger auf ein Bytearray, das den Konfigurationsnamen enthält. Das Array muss null enden und höchstens WIFICONFIG_CONFIG_NAME_MAX_LENGTH Bytes sein, ohne das Beendigungszeichen.

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.

  • EEXIST: ist configName nicht eindeutig.

  • EFAULT: ist configName NULL.

  • EINVAL: die networkId ist ungültig.

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

  • ENODEV: stimmt networkId mit keinem der gespeicherten Netzwerke überein.

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

  • ERANGE: hat configName weniger als ein Zeichen oder mehr als WIFICONFIG_CONFIG_NAME_MAX_LENGTH Zeichen.

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

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.