Freigeben über

WifiConfig_SetPSK-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Legt den vorinstallierten Schlüssel (Pre-Shared Key, PSK) für ein Wi-Fi-Netzwerk fest. Das PSK wird für Netzwerke verwendet, die mit dem WifiConfig_Security_Wpa2_Psk Sicherheitstyp konfiguriert sind.

Die Einstellung wird sofort wirksam, wird aber nicht über Geräteneustarts hinweg beibehalten, es sei denn, die WifiConfig_PersistConfig Funktion wird nach dieser Funktion aufgerufen.

static int WifiConfig_SetPSK(int networkId, const char *psk, size_t pskLength);

Parameter

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

  • psk Ein Zeiger auf den Puffer, der den PSK für das Netzwerk enthält.

  • pskLength Die Länge des PSK für das Netzwerk. Dieser Parameter muss kleiner oder gleich WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZEsein.

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: Der psk Parameter ist NULL.

  • ERANGE: Der pskLength Parameter ist größer als WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

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

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

  • EINVAL: Der networkId Parameter ist ungültig.

  • ENODEV: Der networkId Parameter stimmt mit keiner der IDs der gespeicherten Netzwerke überein.

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.