Partager via

fonction WifiConfig_SetClientCertStoreIdentifier

  • Article

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

Définit l’identificateur du certificat stocké à utiliser comme certificat client pour un réseau Wi-Fi. Le paramètre est effectif immédiatement, mais sera perdu lors d’un redémarrage, sauf si l’application appelle WifiConfig_PersistConfig après le retour de cette fonction.

static int WifiConfig_SetClientCertStoreIdentifier(int networkId, const char *certStoreIdentifier);

Paramètres

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

  • certStoreIdentifier Pointeur vers le nom du certificat. Le nom doit être une chaîne unique de 1 à CERTSTORE_MAX_IDENTIFIER_LENGTH octets, à l’exception du caractère terminateur NULL.

Erreurs

Retourne -1 si une erreur se produit et définit errno sur la valeur d’erreur.

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

  • EFAULT : le certStoreIdentifier paramètre est NULL.

  • ERANGE : la longueur du certStoreIdentifier paramètre est supérieure à CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • 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 il n’existe aucune garantie que le même comportement sera conservé via les 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é EnterpriseWifiConfig.