Share via

CertStore_GetCertificateSubjectName function

  • Article

Header: #include <applibs/certstore.h>

Gets the subject name field from a certificate.

static int CertStore_GetCertificateSubjectName(const char *identifier, struct CertStore_SubjectName *outSubjectName);

Parameters

  • identifier The ID of the certificate.

  • outSubjectName A pointer to a CertStore_SubjectName structure to receive the subject name.

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 identifier is NULL.

  • EINVAL: the identifier parameter specifies an invalid or corrupted certificate.

  • ENOENT: the identifier certificate cannot be found.

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.