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
networkIdID du réseau pour lequel définir l’identificateur du magasin de certificats. WifiConfig_AddNetwork retourne l’ID réseau.certStoreIdentifierPointeur vers une chaîne de caractères constante terminée par null qui contient le nom du certificat. Le nom doit être une chaîne unique d’un àCERTSTORE_MAX_IDENTIFIER_LENGTHun caractère de longueur. Pour plus d’informations, consultez fonction CertStore_InstallRootCACertificate .
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
certStoreIdentifierparamètre est NULL.ERANGE : la longueur du
certStoreIdentifierparamè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
networkIdparamètre n’est pas valide.ENODEV : le
networkIdparamè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.