función CertStore_GetCertificateIdentifierAt

Encabezado: #include <applibs/certstore.h>

Obtiene el identificador del certificado en el índice especificado.

int CertStore_GetCertificateIdentifierAt(size_t index, CertStore_Identifier *outIdentifier);

Parámetros

• index El índice del certificado. Los valores de índice van desde 0 hasta el número total de certificados del dispositivo.

• outIdentifier Puntero a la estructura de CertStore_Identifier que recibe el id. 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 de OS aún no está listo.

• EFAULT: el outIdentifier parámetro es NULL.

• ENOENT: no hay ningún certificado en el índice especificado.

• ERANGE: el index no está en el rango válido.

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.