Megosztás a következőn keresztül:

CertStore_MoveCertificate függvény

  • Cikk

Fejléc: #include <applibs/certstore.h>

Átnevez egy tanúsítványt. Mindkét tanúsítványnak telepítve kell lennie a tanúsítványtárolóban.

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

Paraméterek

  • sourceIdentifier A tanúsítvány aktuális azonosítója.

  • destIdentifier A tanúsítvány új azonosítója.

Hibák

-1 értéket ad vissza, ha hiba történik, és a hibaértékre van halmazva errno .

  • EACCES: a művelet nem engedélyezett, mert a CertStore képesség nincs beállítva az alkalmazásjegyzékben.

  • EAGAIN: Az operációs rendszer tanúsítványtároló összetevője még nem áll készen.

  • EFAULT: a sourceIdentifier vagy destIdentifier paraméter null értékű.

  • EINVAL: a vagy destIdentifier paraméter sourceIdentifier nem érvényes azonosítónév.

  • ENOENT: az azonosítóval sourceIdentifier rendelkező tanúsítvány nem létezik.

errno Más is megadható; az ilyen hibák nem determinisztikusak, és nem garantálható, hogy a rendszerfrissítések ugyanazt a viselkedést megőrzik.

Visszatérési érték

0 értéket ad vissza a sikerhez, vagy -1 hibát, amely esetben errno a hibaérték van beállítva.

Alkalmazásjegyzékre vonatkozó követelmények

Az alkalmazásjegyzéknek tartalmaznia kell a CertStore képességet.

Megjegyzések

Ha már létezik azonosítóval destIdentifier rendelkező tanúsítványtípus, a tanúsítványt a következő helyen lévő tanúsítvány sourceIdentifiertartalmára cseréli, és a sourceidentifier már nem fog létezni.

Figyelem

Mivel a tanúsítványazonosítók rendszerszintűek, egy az sphere parancs vagy függvényhívás, amely új tanúsítványt ad hozzá, felülírhat egy korábbi parancs vagy függvényhívás által hozzáadott tanúsítványt, ami hálózati kapcsolati hibákat okozhat. Határozottan javasoljuk, hogy dolgozzon ki egyértelmű tanúsítványfrissítési eljárásokat, és körültekintően válassza ki a tanúsítványazonosítókat.

További információ arról, hogy az Azure Sphere hogyan használja a tanúsítványazonosítókat: Tanúsítványazonosítók .

Ez a függvény átnevezi a tanúsítványokat, de nem frissíti azokat a konfigurációkat, amelyekben használják őket. Az átnevezett tanúsítványok használatához az alkalmazásnak újra kell betöltenie a Wi-Fi konfigurációját a WifiConfig_ReloadConfig meghívásával. Wi-Fi csak a-t sourceIdentifier használó konfigurációkat kell frissíteni egy érvényes azonosító használatához.