Freigeben über

WifiConfig_StoreOpenNetwork-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Wichtig

Diese Funktion ist veraltet. Verwenden Sie stattdessen WifiConfig_AddNetwork .

Speichert ein offenes Wi-Fi-Netzwerk ohne Schlüssel. Diese Funktion ist nicht threadsicher.

Diese Funktion schlägt fehl, wenn auf dem Gerät bereits ein identisches Netzwerk ohne Schlüssel gespeichert ist. Weitere Informationen finden Sie im Fehlerabschnitt (EEXIST). Wenn ein gespeichertes Netzwerk jedoch einen Schlüssel zusammen mit derselben SSID enthält, ist diese Funktion erfolgreich und speichert das Netzwerk.

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

Parameter

  • ssid Ein Zeiger auf ein SSID-Bytearray mit nicht angegebener Zeichencodierung, die das Wi-Fi Netzwerks identifiziert.

  • ssidLength Die Anzahl der Bytes in der SSID des Wi-Fi Netzwerks.

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.

  • EEXIST: Ein gespeichertes Wi-Fi Netzwerk, das dieselbe SSID aufweist und noch kein Schlüssel vorhanden ist.

  • EFAULT: ist ssid NULL.

  • ERANGE: ist ssidLength 0 oder größer als WIFICONFIG_SSID_MAX_LENGTH.

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

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

  • ENOSPC: Es gibt zu viele Wi-Fi Netzwerke, als dass die Konfiguration beibehalten werden kann; Entfernen Sie eine, und versuchen Sie es erneut.

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.