CertStore_MoveCertificate fonction

Article
08/09/2023

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

Renomme un certificat. Les deux certificats doivent déjà être installés dans le magasin de certificats.

int CertStore_MoveCertificate(const char *sourceIdentifier, const char *destIdentifier);

Paramètres

sourceIdentifier ID actuel du certificat.
destIdentifier Nouvel ID du certificat.

Erreurs

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

EACCES : l’opération n’est pas autorisée, car la fonctionnalité CertStore n’est pas définie dans le manifeste de l’application.
EAGAIN : le composant magasin de certificats de système d’exploitation n’est pas encore prêt.
EFAULT : le sourceIdentifier paramètre ou destIdentifier est NULL.
EINVAL : le sourceIdentifier paramètre ou destIdentifier n’est pas un nom d’identificateur valide.
ENOENT : le certificat avec l’identificateur sourceIdentifier n’existe pas.

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

Remarques

S’il existe déjà un type de certificat avec identificateur destIdentifier , il est remplacé par le contenu du certificat dans sourceIdentifier, et le n’existe sourceidentifier plus.

Attention

Étant donné que les ID de certificat sont à l’échelle du système, une commande azsphere ou un appel de fonction qui ajoute un nouveau certificat peut remplacer un certificat qui a été ajouté par une commande ou un appel de fonction antérieur, ce qui peut entraîner des échecs de connexion réseau. Nous vous recommandons vivement de développer des procédures de mise à jour de certificat claires et de choisir soigneusement les ID de certificat.

Pour plus d’informations sur la façon dont Azure Sphere utilise les ID de certificat, consultez ID de certificat.

Cette fonction renomme les certificats, mais ne met pas à jour les configurations dans lesquelles ils sont utilisés. Pour utiliser les certificats renommés, l’application doit recharger la configuration Wi-Fi en appelant WifiConfig_ReloadConfig. Wi-Fi configurations qui utilisent uniquement le sourceIdentifier doit être mis à jour pour utiliser un identificateur valide.

Partager via