CertStore_MoveCertificate-Funktion

  • Artikel

Header: #include <applibs/certstore.h>

Benennt ein Zertifikat um. Beide Zertifikate müssen bereits im Zertifikatspeicher installiert sein.

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

Parameter

  • sourceIdentifier Die aktuelle ID des Zertifikats.

  • destIdentifier Die neue ID für das Zertifikat.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

  • EACCES: Der Vorgang ist nicht zulässig, da die CertStore-Funktion im Anwendungsmanifest nicht festgelegt ist.

  • EAGAIN: Die Zertifikatspeicherkomponente des Betriebssystems ist noch nicht bereit.

  • EFAULT: Der sourceIdentifier Parameter oder destIdentifier ist NULL.

  • EINVAL: Der sourceIdentifier Parameter oder destIdentifier ist kein gültiger Bezeichnername.

  • ENOENT: Das Zertifikat mit dem Bezeichner sourceIdentifier ist nicht vorhanden.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und es gibt keine Garantie, dass das gleiche Verhalten durch Systemupdates beibehalten wird.

Rückgabewert

Gibt 0 für erfolg oder -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die CertStore-Funktion enthalten.

Bemerkungen

Wenn bereits ein Zertifikattyp mit bezeichner destIdentifier vorhanden ist, wird er durch den Inhalt des Zertifikats unter sourceIdentifierersetzt, und der sourceidentifier ist nicht mehr vorhanden.

Vorsicht

Da Zertifikat-IDs systemweit sind, kann ein azsphere-Befehl oder ein Funktionsaufruf, der ein neues Zertifikat hinzufügt, ein Zertifikat überschreiben, das von einem früheren Befehl oder Funktionsaufruf hinzugefügt wurde, was zu Netzwerkverbindungsfehlern führen kann. Es wird dringend empfohlen, eindeutige Prozeduren für die Zertifikataktualisierung zu entwickeln und Zertifikat-IDs sorgfältig auszuwählen.

Weitere Informationen zur Verwendung von Zertifikat-IDs in Azure Sphere finden Sie unter Zertifikat-IDs .

Diese Funktion benennt die Zertifikate um, aktualisiert jedoch nicht die Konfigurationen, in denen sie verwendet werden. Um die umbenannten Zertifikate verwenden zu können, muss die App die Wi-Fi-Konfiguration erneut laden, indem WifiConfig_ReloadConfig aufgerufen wird. Wi-Fi Konfigurationen, die nur verwenden, sourceIdentifier müssen aktualisiert werden, um einen gültigen Bezeichner zu verwenden.