Partilhar via

função CertStore_MoveCertificate

  • Artigo

Cabeçalho: #include <applibs/certstore.h>

Muda o nome de um certificado. Ambos os certificados já têm de estar instalados no arquivo de certificados.

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

Parâmetros

  • sourceIdentifier O ID atual do certificado.

  • destIdentifier O novo ID do certificado.

Erros

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

  • EACCES: a operação não é permitida porque a capacidade CertStore não está definida no manifesto da aplicação.

  • EAGAIN: o componente de arquivo de certificados do SO ainda não está pronto.

  • EFAULT: o sourceIdentifier parâmetro ou destIdentifier é NULL.

  • EINVAL: o sourceIdentifier parâmetro ou destIdentifier não é um nome de identificador válido.

  • ENOENT: o certificado com o identificador sourceIdentifier não existe.

Qualquer outro errno também pode ser especificado; tais erros não são deterministas e não há garantias de que o mesmo comportamento será mantido através de atualizações do sistema.

Valor devolvido

Devolve 0 para êxito ou -1 para falha, caso errno em que está definido como o valor de erro.

Requisitos do manifesto de aplicação

O manifesto da aplicação tem de incluir a capacidade CertStore.

Observações

Se já existir algum tipo de certificado com identificador destIdentifier , este será substituído pelo conteúdo do certificado em sourceIdentifiere o sourceidentifier deixará de existir.

Atenção

Uma vez que os IDs de certificado são ao nível do sistema, um az sphere comando ou uma chamada de função que adiciona um novo certificado pode substituir um certificado que foi adicionado por uma chamada de comando ou função anterior, causando potencialmente falhas de ligação de rede. Recomendamos vivamente que desenvolva procedimentos de atualização de certificados claros e escolha cuidadosamente os IDs de certificado.

Veja IDs de certificado para obter mais informações sobre como o Azure Sphere utiliza IDs de certificado.

Esta função muda o nome dos certificados, mas não atualiza as configurações nas quais são utilizados. Para utilizar os certificados renomeados, a aplicação tem de recarregar a configuração do Wi-Fi ao chamar WifiConfig_ReloadConfig. Wi-Fi configurações que utilizam apenas o sourceIdentifier têm de ser atualizadas para utilizar um identificador válido.