מידע על המבנה של SuplCertificateInterface
#include <
gps.h
>
שדות נתונים |
|
size_t | size |
int(* | install_certificates )(const DerEncodedCertificate *certificates, size_t length) |
int(* | revoke_certificates )(const Sha1CertificateFingerprint *fingerprints, size_t length) |
תיאור מפורט
מסמכי תיעוד של שדה
int(* install_certificates)(const DerEncodedCertificate *certificates, size_t length) |
התקנה של קבוצת אישורים המשמשים לחיבורי SUPL לשרת AGPS. אם יש צורך, ה-HAL צריך לבדוק באופן פנימי אילו אישורים צריך להסיר כדי להתקין את האישורים הרצויים. האישורים שמותקנים מייצגים קבוצה מלאה של אישורים תקפים שנדרשים כדי להתחבר לשרתי AGPS SUPL. רשימת האישורים נדרשת, וכל האישורים חייבים להיות זמינים בו-זמנית כשמנסים ליצור חיבור לשרת AGPS.
פרמטרים: certificates – מציין למערך של אישורים מקודדים ב-DER שצריך להתקין ב-HAL. length – מספר האישורים להתקנה. הפונקציה מחזירה את הערך AGPS_CERTIFICATE_OPERATION_SUCCESS אם הפעולה הושלמה בהצלחה, ואת הערך AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES אם ה-HAL לא יכול לאחסן את מספר האישורים שניסו להתקין. במקרה של שגיאה, המצב של האישורים ששמורים אמור להישאר זהה למצב הקודם.
חשוב: במקרה הצורך, ה-HAL צריך לברר באופן פנימי את קבוצת האישורים שצריך להסיר כדי להתקין את האישורים הרצויים.
int(* revoke_certificates)(const Sha1CertificateFingerprint *fingerprints, size_t length) |
הודעה ל-HAL על ביטול רשימת אישורים ששימשו לחיבורי SUPL. צפויה הסרה של קבוצת האישורים הנתונה מהמאגר הפנימי של HAL.
פרמטרים: fingerprints – מציין למערך של טביעות אצבע SHA1 לזיהוי קבוצת האישורים שרוצים לבטל. length – מספר טביעות האצבע שסופקו. הפונקציה מחזירה את הערך AGPS_CERTIFICATE_OPERATION_SUCCESS אם הפעולה הושלמה בהצלחה.
חשוב: אם HAL לא מכיר אחד מהאישורים שסופקו (דרך טביעת האצבע שלו), צריך להתעלם ממנו ולהמשיך לבטל או למחוק את שאר האישורים.
התיעוד של המבנה הזה נוצר מהקובץ הבא:
- hardware/libhardware/include/hardware/ gps.h