Compartir a través de

función CertStore_MoveCertificate

  • Artículo

Encabezado: #include <applibs/certstore.h>

Cambia el nombre de un certificado. Ambos certificados ya deben estar instalados en el almacén de certificados.

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

Parámetros

  • sourceIdentifier El id. actual del certificado.

  • destIdentifier El nuevo identificador del certificado.

Errores

Devuelve -1 si se encuentra un error y se establece errno en el valor de error.

  • EACCES: la operación no está permitida porque la funcionalidad CertStore no está establecida en el manifiesto de la aplicación.

  • EAGAIN: el componente de almacén de certificados del sistema operativo aún no está listo.

  • EFAULT: el sourceIdentifier parámetro or destIdentifier es NULL.

  • EINVAL: el sourceIdentifier parámetro or destIdentifier no es un nombre de identificador válido.

  • ENOENT: el certificado con el identificador sourceIdentifier no existe.

También se puede especificar cualquier otro errno error; estos errores no son deterministas y no hay ninguna garantía de que el mismo comportamiento se conservará a través de las actualizaciones del sistema.

Valor devuelto

Devuelve 0 para éxito o -1 para error, en cuyo caso errno se establece en el valor de error.

Requisitos del manifiesto de la aplicación

El manifiesto de la aplicación debe incluir la funcionalidad CertStore.

Observaciones

Si ya existe cualquier tipo de certificado con identificador destIdentifier , se reemplazará por el contenido del certificado en sourceIdentifiery sourceidentifier dejará de existir.

Precaución

Dado que los identificadores de certificado son de todo el sistema, un az sphere comando o una llamada de función que agrega un certificado nuevo puede sobrescribir un certificado agregado por una llamada de función o comando anterior, lo que puede provocar errores en la conexión de red. Le recomendamos encarecidamente que desarrolle procedimientos claros de actualización de certificados y elija cuidadosamente los identificadores de certificado.

Consulte Identificadores de certificado para obtener más información sobre cómo Azure Sphere usa identificadores de certificado.

Esta función cambia el nombre de los certificados, pero no actualiza las configuraciones en las que se usan. Para usar los certificados con el nombre cambiado, la aplicación debe volver a cargar la configuración de Wi-Fi llamando a WifiConfig_ReloadConfig. Wi-Fi configuraciones que usan solo la sourceIdentifier deben actualizarse para usar un identificador válido.