WifiConfig_SetPSK-Funktion
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 gleichWIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE
sein.
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 alsWIFICONFIG_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.