Partager via

WifiConfig_SetPSK, fonction

  • Article

En-tête : #include <applibs/wificonfig.h>

Définit la clé pré-partagée (PSK) pour un réseau Wi-Fi. La clé PSK est utilisée pour les réseaux configurés avec le type de WifiConfig_Security_Wpa2_Psk sécurité.

Le paramètre est effectif immédiatement, mais ne sera pas conservé sur les redémarrages de l’appareil, sauf si la fonction WifiConfig_PersistConfig est appelée après cette fonction.

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

Paramètres

  • networkId ID du réseau à configurer. WifiConfig_AddNetwork retourne l’ID réseau.

  • psk Pointeur vers la mémoire tampon qui contient la clé PSK pour le réseau.

  • pskLength Longueur de la clé PSK pour le réseau. Ce paramètre doit être inférieur ou égal à WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

Erreurs

Retourne -1 si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EACCES : le manifeste de l’application n’inclut pas la fonctionnalité WifiConfig.

  • EFAULT : le psk paramètre est NULL.

  • ERANGE : le pskLength paramètre est supérieur à WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

  • EAGAIN : l’appareil Wi-Fi n’est pas prêt.

  • ENETDOWN : l’interface réseau Wi-Fi n’est pas disponible.

  • EINVAL : le networkId paramètre n’est pas valide.

  • ENODEV : le networkId paramètre ne correspond à aucun des ID des réseaux stockés.

Toutes les autres errno peuvent également être spécifiées ; ces erreurs ne sont pas déterministes et le même comportement peut ne pas être conservé par le biais des mises à jour système.

Valeur de retour

Retourne 0 pour la réussite, ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur.

Exigences du manifeste d’application

Le manifeste de l’application doit inclure la fonctionnalité WifiConfig.