CertStore_GetCertificateSubjectName函数

标头: #include <applibs/certstore.h>

从证书中获取使用者名称字段。

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

参数

  • identifier 证书的 ID。

  • outSubjectName 指向用于接收使用者名称 的CertStore_SubjectName 结构的指针。

错误

如果遇到错误并设置为 errno 错误值,则返回 -1。

  • EACCES:不允许此操作,因为应用程序清单中未设置 CertStore 功能。

  • EAGAIN:OS 证书存储组件尚未准备就绪。

  • EFAULT:为 identifier NULL。

  • EINVAL: identifier 参数指定无效或损坏的证书。

  • ENOENT: identifier 找不到证书。

还可以指定任何其他 errno 错误;此类错误不是确定性的,也不能保证通过系统更新保留相同的行为。

返回值

如果成功,则返回 0,如果失败,则返回 -1,在这种情况下 errno ,将 设置为错误值。

应用程序清单要求

应用程序清单必须包含 CertStore 功能。