Dela via

funktionen CertStore_MoveCertificate

  • Artikel

Sidhuvud: #include <applibs/certstore.h>

Byter namn på ett certifikat. Båda certifikaten måste redan vara installerade i certifikatarkivet.

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

Parametrar

  • sourceIdentifier Certifikatets aktuella ID.

  • destIdentifier Det nya ID:t för certifikatet.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: åtgärden tillåts inte eftersom CertStore-funktionen inte anges i programmanifestet.

  • EAGAIN: komponenten för OS-certifikatarkivet är inte klar än.

  • EFAULT: parametern eller destIdentifier parametern sourceIdentifier är NULL.

  • EINVAL: parametern sourceIdentifier eller destIdentifier är inte ett giltigt identifierarnamn.

  • ENOENT: certifikatet med identifieraren sourceIdentifier finns inte.

errno Andra kan också anges, sådana fel är inte deterministiska och det finns ingen garanti för att samma beteende behålls via systemuppdateringar.

Returvärde

Returnerar 0 för lyckat resultat, eller -1 för fel, i vilket fall errno är inställt på felvärdet.

Krav för programmanifest

Programmanifestet måste innehålla CertStore-funktionen.

Anmärkningar

Om det redan finns någon typ av certifikat med identifierare destIdentifier ersätts det med innehållet i certifikatet i sourceIdentifieroch sourceidentifier kommer inte längre att finnas.

Försiktighet

Eftersom certifikat-ID:t är systemomfattande kan ett az sphere kommando eller ett funktionsanrop som lägger till ett nytt certifikat skriva över ett certifikat som har lagts till av ett tidigare kommando- eller funktionsanrop, vilket kan orsaka fel i nätverksanslutningen. Vi rekommenderar starkt att du utvecklar tydliga procedurer för certifikatuppdatering och väljer certifikat-ID:er noggrant.

Mer information om hur Azure Sphere använder certifikat-ID finns i Certifikat-ID :er.

Den här funktionen byter namn på certifikaten men uppdaterar inte de konfigurationer där de används. Om du vill använda de omdöpta certifikaten måste appen läsa in den Wi-Fi konfigurationen igen genom att ringa WifiConfig_ReloadConfig. Wi-Fi konfigurationer som bara sourceIdentifier använder måste uppdateras för att använda en giltig identifierare.