função CertStore_MoveCertificate

  • Artigo

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

Renomeia um certificado. Ambos os certificados já devem ser instalados no repositório de certificados.

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

Parâmetros

  • sourceIdentifier A ID atual do certificado.

  • destIdentifier A nova ID do certificado.

Erros

Retorna -1 se um erro for encontrado e definir errno como o valor do erro.

  • EACCES: a operação não é permitida porque o recurso CertStore não está definido no manifesto do aplicativo.

  • EAGAIN: o componente do repositório de certificados do sistema operacional 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; esses erros não são determinísticos e não há garantia de que o mesmo comportamento será mantido por meio de atualizações do sistema.

Valor retornado

Retorna 0 para êxito ou -1 para falha, nesse caso errno é definido como o valor do erro.

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso CertStore.

Observações

Se algum tipo de certificado com identificador destIdentifier já existir, ele será substituído pelo conteúdo do certificado em sourceIdentifier, e o sourceidentifier não existirá mais.

Cuidado

Como as IDs de certificado são em todo o sistema, um az sphere comando ou uma chamada de função que adiciona um novo certificado pode substituir um certificado que foi adicionado por um comando ou chamada de função anterior, potencialmente causando falhas de conexão de rede. Recomendamos que você desenvolva procedimentos claros de atualização de certificado e escolha as IDs de certificado cuidadosamente.

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

Essa função renomeia os certificados, mas não atualiza as configurações nas quais eles são usados. Para usar os certificados renomeados, o aplicativo deve recarregar a configuração de Wi-Fi chamando WifiConfig_ReloadConfig. Wi-Fi configurações que usam apenas o sourceIdentifier devem ser atualizados para usar um identificador válido.