SuplCertificateInterface-Strukturreferenz
#include <
gps.h
>
Datenfelder |
|
| size_t | size |
| int(* | install_certificates )(const DerEncodedCertificate *certificates, size_t length) |
| int(* | revoke_certificates )(const Sha1CertificateFingerprint *fingerprints, size_t length) |
Detaillierte Beschreibung
AGPS-Schnittstelle zum Verwalten von SUPL-Zertifikatsvorgängen
Felddokumentation
| int(* install_certificates)(const DerEncodedCertificate *certificates, size_t length) |
Hiermit werden eine Reihe von Zertifikaten installiert, 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 zu AGPS SUPL-Servern erforderlich sind. Die Liste der Zertifikate ist erforderlich und alle müssen gleichzeitig verfügbar sein, wenn versucht wird, eine Verbindung zum AGPS-Server herzustellen.
Parameter: certificates – Ein Verweis auf ein Array von DER-codierten Zertifikaten, die in der HAL installiert werden müssen. length – Die Anzahl der zu installierenden Zertifikate. Gibt Folgendes zurück: AGPS_CERTIFICATE_OPERATION_SUCCESS, wenn der Vorgang erfolgreich abgeschlossen wurde, AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES, wenn die HAL die Anzahl der Zertifikate, die installiert werden sollen, nicht speichern kann. Der Status der gespeicherten Zertifikate sollte in diesem Fehlerfall unverändert bleiben.
WICHTIG: Bei Bedarf sollte der 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 darüber, dass eine Liste der Zertifikate, die für SUPL-Verbindungen verwendet werden, widerrufen wurde. Es wird davon ausgegangen, dass die angegebenen Zertifikate aus dem internen Speicher der HAL entfernt werden.
Parameter: fingerprints – Ein Verweis auf ein Array von SHA1-Fingerabdrücken, um die zu widerrufenden Zertifikate zu identifizieren. length – Die Anzahl der angegebenen Fingerabdrücke. Gibt AGPS_CERTIFICATE_OPERATION_SUCCESS zurück, wenn der Vorgang erfolgreich abgeschlossen wurde.
WICHTIG: Wenn eines der über den Fingerabdruck bereitgestellten Zertifikate dem HAL nicht bekannt ist, sollte es ignoriert und der Widerruf/die Löschung der übrigen fortgesetzt werden.
Die Dokumentation für diese Struktur wurde aus der folgenden Datei generiert:
- hardware/libhardware/include/hardware/ gps.h