Sdílet prostřednictvím

CertStore_MoveCertificate funkce

  • Článek

Hlavička: #include <applibs/certstore.h>

Přejmenuje certifikát. Oba certifikáty už musí být nainstalované v úložišti certifikátů.

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

Parametry

  • sourceIdentifier Aktuální ID certifikátu.

  • destIdentifier Nové ID certifikátu.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Operace není povolená, protože v manifestu aplikace není nastavená funkce CertStore.

  • EAGAIN: Komponenta úložiště certifikátů operačního systému ještě není připravená.

  • EFAULT: sourceIdentifier parametr nebo destIdentifier má hodnotu NULL.

  • EINVAL: sourceIdentifier Parametr nebo destIdentifier není platný název identifikátoru.

  • ENOENT: Certifikát s identifikátorem sourceIdentifier neexistuje.

Je také možné zadat jakékoli jiné errno chyby. Tyto chyby nejsou deterministické a neexistuje žádná záruka, že se stejné chování zachová prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí hodnotu 0 pro úspěch nebo -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci CertStore.

Poznámky

Pokud už nějaký typ certifikátu s identifikátorem destIdentifier existuje, nahradí se obsahem certifikátu na adrese sourceIdentifiera sourceidentifier už nebude existovat.

Pozor

Vzhledem k tomu, že ID certifikátů jsou pro celý systém, az sphere může příkaz nebo volání funkce, které přidává nový certifikát, přepsat certifikát přidaný dřívějším voláním příkazu nebo funkce, což může způsobit selhání síťového připojení. Důrazně doporučujeme vyvinout jasné postupy aktualizace certifikátů a pečlivě zvolit ID certifikátů.

Další informace o tom, jak Azure Sphere používá ID certifikátů, najdete v tématu ID certifikátů.

Tato funkce certifikáty přejmenuje, ale neaktualizuje konfigurace, ve kterých se používají. Aby bylo možné použít přejmenované certifikáty, musí aplikace znovu načíst konfiguraci Wi-Fi voláním WifiConfig_ReloadConfig. Wi-Fi konfigurace, které používají pouze identifikátor, sourceIdentifier musí být aktualizovány tak, aby používaly platný identifikátor.