Share via

WifiConfig_StoreWpa2Network-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Wichtig

Diese Funktion ist veraltet. Verwenden Sie stattdessen WifiConfig_AddNetwork .

Speichert ein WPA2-Wi-Fi Netzwerk, das einen vorinstallierten Schlüssel verwendet. Diese Funktion ist nicht threadsicher.

Hinweis

Diese Funktion schlägt fehl, wenn bereits ein Netzwerk mit der gleichen SSID und demselben vorinstallierten Schlüssel gespeichert ist. Weitere Informationen finden Sie im Fehlerabschnitt (EEXIST).

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

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.

  • psk Ein Zeiger auf einen Puffer, der den vorinstallierten Schlüssel für das Wi-Fi Netzwerk enthält.

  • pskLength Die Länge des vorinstallierten Schlüssels für das Wi-Fi-Netzwerk.

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 ist bereits vorhanden, das dieselbe SSID aufweist und WPA2 verwendet.

  • EFAULT: oder ssidpsk ist NULL.

  • ERANGE: Der ssidLength Parameter oder pskLength ist 0 oder größer als WIFICONFIG_SSID_MAX_LENGTH und WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

  • 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.