SuplCertificateInterface-Strukturreferenz
#include < gps.h >
Datenfelder | |
size_t | Größe |
int (* | install_certificates ) (const DerEncodedCertificate * -Zertifikate, size_t length) |
int (* | revoke_certificates ) (const Sha1CertificateFingerprint * Fingerabdrücke, size_t Länge) |
detaillierte Beschreibung
AGPS-Schnittstelle zur Abwicklung von SUPL-Zertifikatvorgängen
Felddokumentation
int (* install_certificates) (const DerEncodedCertificate * -Zertifikate, size_t length) |
Installiert eine Reihe von Zertifikaten, die für SUPL-Verbindungen zum AGPS-Server verwendet werden. Bei Bedarf sollte die HAL intern alle Zertifikate ermitteln, die entfernt werden müssen, um die zu installierenden Zertifikate aufzunehmen. Die installierten Zertifikate stellen einen vollständigen Satz gültiger Zertifikate dar, die für die Verbindung mit AGPS SUPL-Servern erforderlich sind. Die Liste der Zertifikate ist erforderlich und muss alle gleichzeitig verfügbar sein, wenn versucht wird, eine Verbindung mit dem AGPS-Server herzustellen.
Parameter: Zertifikate - Ein Zeiger auf ein Array von DER-codierten Zertifikaten, die in der HAL installiert werden müssen. Länge - Die Anzahl der zu installierenden Zertifikate. Rückgabe: AGPS_CERTIFICATE_OPERATION_SUCCESS Wenn der Vorgang erfolgreich abgeschlossen wurde AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES Wenn die HAL die Anzahl der zu installierenden Zertifikate nicht speichern kann, sollte der Status der gespeicherten Zertifikate in diesem Fehlerfall unverändert bleiben.
WICHTIG: Bei Bedarf sollte die HAL intern herausfinden, welche Zertifikate entfernt werden müssen, um die zu installierenden Zertifikate aufzunehmen.
int (* revoke_certificates) (const Sha1CertificateFingerprint * Fingerabdrücke, size_t Länge) |
Benachrichtigt die HAL, dass eine Liste der für SUPL-Verbindungen verwendeten Zertifikate widerrufen wird. Es wird erwartet, dass der angegebene Satz von Zertifikaten aus dem internen Speicher der HAL entfernt wird.
Parameter: Fingerabdrücke - Ein Zeiger auf ein Array von SHA1-Fingerabdrücken, um den Satz von Zertifikaten zu identifizieren, die widerrufen werden sollen. Länge - Die Anzahl der bereitgestellten Fingerabdrücke. Rückgabe: AGPS_CERTIFICATE_OPERATION_SUCCESS, wenn der Vorgang erfolgreich abgeschlossen wurde.
WICHTIG: Wenn eines der bereitgestellten Zertifikate (über seinen Fingerabdruck) der HAL nicht bekannt ist, sollte es ignoriert werden und der Rest der Zertifikate weiterhin widerrufen / gelöscht werden.
Die Dokumentation für diese Struktur wurde aus der folgenden Datei generiert:
- hardware / libhardware / include / hardware / gps.h.