Condividi tramite

CertStore_MoveCertificate

  • Articolo

Intestazione: #include <applicazioni/certstore.h>

Rinomina un certificato. Entrambi i certificati devono essere già installati nell'archivio certificati.

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

Parametri

  • sourceIdentifier ID corrente del certificato.

  • destIdentifier Il nuovo ID per il certificato.

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EACCES: l'operazione non è consentita perché la funzionalità CertStore non è impostata nel manifesto dell'applicazione.

  • EAGAIN: il componente archivio certificati del sistema operativo non è ancora pronto.

  • EFAULT: il sourceIdentifier parametro or destIdentifier è NULL.

  • EINVAL: il sourceIdentifier parametro or destIdentifier non è un nome identificatore valido.

  • ENOENT: il certificato con l'identificatore sourceIdentifier non esiste.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e non vi è alcuna garanzia che lo stesso comportamento verrà mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce 0 per operazione riuscita o -1 per errore, nel qual caso errno è impostato sul valore di errore.

Requisiti del manifesto dell'applicazione

Il manifesto dell'applicazione deve includere la funzionalità CertStore.

Osservazioni

Se esiste già un tipo di certificato con identificatore destIdentifier , verrà sostituito con il contenuto del certificato in sourceIdentifiere sourceidentifier il non esisterà più.

Attenzione

Poiché gli ID certificato sono a livello di sistema, un az sphere comando o una chiamata di funzione che aggiunge un nuovo certificato può sovrascrivere un certificato aggiunto da una chiamata di comando o funzione precedente, causando potenzialmente errori di connessione di rete. È consigliabile sviluppare procedure di aggiornamento dei certificati chiare e scegliere con attenzione gli ID certificato.

Per altre informazioni su come Azure Sphere usa gli ID certificato, vedere ID certificato .

Questa funzione rinomina i certificati, ma non aggiorna le configurazioni in cui vengono usati. Per usare i certificati rinominati, l'app deve ricaricare la configurazione Wi-Fi chiamando WifiConfig_ReloadConfig. Wi-Fi configurazioni che utilizzano solo il sourceIdentifier deve essere aggiornato per utilizzare un identificatore valido.