SuplCertificateInterface-Strukturreferenz
#include < gps.h >
Datenfelder | |
| size_t | Größe |
| int(* | install_certificates )(const DerEncodedCertificate *certificates, size_t length) |
| int(* | revoke_certificates )(const Sha1CertificateFingerprint *Fingerabdrücke, size_t Länge) |
detaillierte Beschreibung
AGPS-Schnittstelle zur Abwicklung von SUPL-Zertifikatoperationen
Felddokumentation
| int(* install_certificates)(const DerEncodedCertificate *certificates, 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 unterzubringen. 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 alle müssen 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 im HAL installiert werden müssen. Länge – Die Anzahl der zu installierenden Zertifikate. Gibt zurück: 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 derselbe bleiben wie zuvor.
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 *fingerprints, size_t length) |
Benachrichtigt die HAL, dass eine Liste von Zertifikaten, die für SUPL-Verbindungen verwendet werden, widerrufen wurde. Es wird erwartet, dass der angegebene Satz von Zertifikaten aus dem internen Speicher des HAL entfernt wird.
Parameter: Fingerabdrücke – Ein Zeiger auf ein Array von SHA1-Fingerabdrücken, um den Satz der zu widerrufenden Zertifikate zu identifizieren. Länge – Die Anzahl der bereitgestellten Fingerabdrücke. Gibt zurück: AGPS_CERTIFICATE_OPERATION_SUCCESS, wenn der Vorgang erfolgreich abgeschlossen wurde.
WICHTIG: Wenn der HAL eines der bereitgestellten Zertifikate (anhand seines Fingerabdrucks) nicht kennt, sollte es ignoriert werden und die restlichen Zertifikate weiterhin widerrufen/löschen.
Die Dokumentation für diese Struktur wurde aus der folgenden Datei generiert:
- hardware/libhardware/include/hardware/ gps.h