CertStore_GetCertificateIdentifierAt function

Header: #include <applibs/certstore.h>

Gets the ID of the certificate at the specified index.

int CertStore_GetCertificateIdentifierAt(size_t index, CertStore_Identifier *outIdentifier);

Parameters

• index The index of the certificate. Index values range from 0 to the total number of certificates on the device.

• outIdentifier A pointer to the CertStore_Identifier struct that receives the ID of the certificate.

Errors

Returns -1 if an error is encountered and sets errno to the error value.

• EACCES: the operation isn't allowed because the CertStore capability isn't set in the application manifest.

• EAGAIN: the OS certstore component isn't ready yet.

• EFAULT: the outIdentifier parameter is NULL.

• ENOENT: there's no certificate at the specified index.

• ERANGE: the index is not in the valid range.

Any other errno may also be specified; such errors aren't deterministic and there's no guarantee that the same behavior will be retained through system updates.

Return value

Returns 0 for success, or -1 for failure, in which case errno is set to the error value.

Application manifest requirements

The application manifest must include the CertStore capability.