CertStore_GetCertificateIdentifierAt-Funktion

Header: #include <applibs/certstore.h>

Ruft die ID des Zertifikats am angegebenen Index ab.

int CertStore_GetCertificateIdentifierAt(size_t index, CertStore_Identifier *outIdentifier);

Parameter

• index Der Index des Zertifikats. Indexwerte reichen von 0 bis zur Gesamtzahl der Zertifikate auf dem Gerät.

• outIdentifier Ein Zeiger auf die CertStore_Identifier Struktur, die die ID des Zertifikats empfängt.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

• EACCES: Der Vorgang ist nicht zulässig, da die CertStore-Funktion im Anwendungsmanifest nicht festgelegt ist.

• EAGAIN: Die Zertifikatspeicherkomponente des Betriebssystems ist noch nicht bereit.

• EFAULT: Der outIdentifier Parameter ist NULL.

• ENOENT: Es gibt kein Zertifikat am angegebenen Index.

• ERANGE: liegt index nicht im gültigen Bereich.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und es gibt keine Garantie, dass das gleiche Verhalten durch Systemupdates beibehalten wird.

Rückgabewert

Gibt 0 für erfolg oder -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die CertStore-Funktion enthalten.