Partager via


WifiConfig_SetRootCACertStoreIdentifier fonction

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

Définit l’identificateur du certificat stocké à utiliser comme autorité de certification racine pour un réseau. Si l’identificateur n’est pas défini, l’appareil n’authentifie pas le serveur auquel il se connecte. Le paramètre est effectif immédiatement, mais sera perdu lors d’un redémarrage, sauf si la fonction WifiConfig_PersistConfig est appelée après cette fonction.

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

Paramètres

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