Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
SuplCertificateInterface-Strukturreferenz
#include <
gps.h
>
AGPS-Schnittstelle zum Verwalten von SUPL-Zertifikatsvorgängen
Definition in Zeile
978
der Datei
gps.h
.
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.
Definition in Zeile
1005
der Datei
gps.h
.
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.
Definition in Zeile
1022
der Datei
gps.h
.
auf sizeof(SuplCertificateInterface) setzen
Definition in Zeile
980
der Datei
gps.h
Die Dokumentation für diese Struktur wurde aus der folgenden Datei generiert:
-
hardware/libhardware/include/hardware/
gps.h
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[],[],null,["# Android Hardware Abstraction Layer: SuplCertificateInterface Struct Reference\n\nSuplCertificateInterface Struct Reference\n=========================================\n\n[Data Fields](#pub-attribs) \nSuplCertificateInterface Struct Reference \n\n`\n#include \u003c\n`[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)`\n\u003e\n`\n\n|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Data Fields ----------- ||\n| size_t | [size](/reference/hal/struct_supl_certificate_interface#a854352f53b148adc24983a58a1866d66) |\n| ||\n| int(\\* | [install_certificates](/reference/hal/struct_supl_certificate_interface#a9208ffa455b013091db3afa2abc2a1a3) )(const [DerEncodedCertificate](/reference/hal/struct_der_encoded_certificate) \\*certificates, size_t length) |\n| ||\n| int(\\* | [revoke_certificates](/reference/hal/struct_supl_certificate_interface#a6c541c29aa9f7a5fb5f44ce4283e98e3) )(const [Sha1CertificateFingerprint](/reference/hal/struct_sha1_certificate_fingerprint) \\*fingerprints, size_t length) |\n| ||\n\n\nDetailed Description\n--------------------\n\n\nAGPS Interface to handle SUPL certificate operations\n\n\nDefinition at line\n[978](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\nField Documentation\n-------------------\n\n\n|------------------------------------------------------------------------------------------------------------------------------------------|\n| int(\\* install_certificates)(const [DerEncodedCertificate](/reference/hal/struct_der_encoded_certificate) \\*certificates, size_t length) |\n\n\nInstalls a set of Certificates used for SUPL connections to the AGPS server. If needed the HAL should find out internally any certificates that need to be removed to accommodate the certificates to install. The certificates installed represent a full set of valid certificates needed to connect to AGPS SUPL servers. The list of certificates is required, and all must be available at the same time, when trying to establish a connection with the AGPS Server.\n\n\nParameters: certificates - A pointer to an array of DER encoded certificates that are need to be installed in the HAL. length - The number of certificates to install. Returns: AGPS_CERTIFICATE_OPERATION_SUCCESS if the operation is completed successfully AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES if the HAL cannot store the number of certificates attempted to be installed, the state of the certificates stored should remain the same as before on this error case.\n\n\nIMPORTANT: If needed the HAL should find out internally the set of certificates that need to be removed to accommodate the certificates to install.\n\n\nDefinition at line\n[1005](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| int(\\* revoke_certificates)(const [Sha1CertificateFingerprint](/reference/hal/struct_sha1_certificate_fingerprint) \\*fingerprints, size_t length) |\n\n\nNotifies the HAL that a list of certificates used for SUPL connections are revoked. It is expected that the given set of certificates is removed from the internal store of the HAL.\n\n\nParameters: fingerprints - A pointer to an array of SHA1 Fingerprints to identify the set of certificates to revoke. length - The number of fingerprints provided. Returns: AGPS_CERTIFICATE_OPERATION_SUCCESS if the operation is completed successfully.\n\n\nIMPORTANT: If any of the certificates provided (through its fingerprint) is not known by the HAL, it should be ignored and continue revoking/deleting the rest of them.\n\n\nDefinition at line\n[1022](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\n|-------------|\n| size_t size |\n\n\nset to sizeof(SuplCertificateInterface)\n\n\nDefinition at line\n[980](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\n*** ** * ** ***\n\nThe documentation for this struct was generated from the following file:\n\n- hardware/libhardware/include/hardware/ [gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)"]]
