CertStore_MoveCertificate functie

Header: #include <applibs/certstore.h>

Hiermee wijzigt u de naam van een certificaat. Beide certificaten moeten al zijn geïnstalleerd in het certificaatarchief.

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

Parameters

• sourceIdentifier De huidige id van het certificaat.

• destIdentifier De nieuwe id voor het certificaat.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

• EACCES: de bewerking is niet toegestaan omdat de CertStore-mogelijkheid niet is ingesteld in het toepassingsmanifest.

• EAGAIN: het onderdeel certificaatarchief van het besturingssysteem is nog niet gereed.

• EFAULT: de sourceIdentifier parameter of destIdentifier is NULL.

• EINVAL: de sourceIdentifier parameter of destIdentifier is geen geldige id-naam.

• ENOENT: het certificaat met de id sourceIdentifier bestaat niet.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en er is geen garantie dat hetzelfde gedrag wordt behouden via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de CertStore-mogelijkheid bevatten.

Opmerkingen

Als er al een type certificaat met id destIdentifier bestaat, wordt dit vervangen door de inhoud van het certificaat op sourceIdentifieren bestaat de sourceidentifier niet meer.

Voorzichtigheid

Omdat certificaat-id's systeembreed zijn, kan een az sphere opdracht of functieaanroep waarmee een nieuw certificaat wordt toegevoegd een certificaat overschrijven dat is toegevoegd door een eerdere opdracht of functieaanroep, waardoor netwerkverbindingsfouten kunnen optreden. We raden u ten zeerste aan duidelijke procedures voor het bijwerken van certificaten te ontwikkelen en certificaat-id's zorgvuldig te kiezen.

Zie Certificaat-id's voor meer informatie over hoe Azure Sphere certificaat-id's gebruikt.

Deze functie wijzigt de naam van de certificaten, maar werkt de configuraties waarin ze worden gebruikt niet bij. Als u de hernoemde certificaten wilt gebruiken, moet de app de Wi-Fi-configuratie opnieuw laden door WifiConfig_ReloadConfig aan te roepen. Wi-Fi configuraties die alleen sourceIdentifier de gebruiken, moeten worden bijgewerkt om een geldige id te gebruiken.