CertStore_GetCertificateIdentifierAt 函数

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

获取指定索引处的证书 ID。

int CertStore_GetCertificateIdentifierAt(size_t index, CertStore_Identifier *outIdentifier);

参数

• index 证书的索引。 索引值的范围从 0 到 设备上的证书总数。

• outIdentifier 指向接收证书 ID 的 CertStore_Identifier 结构的指针。

错误

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

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

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

• EFAULT： outIdentifier 参数为 NULL。

• ENOENT：指定索引处没有证书。

• ERANGE： index 不在有效范围内。

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

返回值

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

应用程序清单要求

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